MeUp Marketplace API
GET https://take.meup.com/public/v1/marketplace
Fetches marketplace items. Supports filtering and pagination.
Authentication
- Required: Yes (Bearer Token)
- Header example:
Authorization: Bearer YOUR_TOKEN_HERE
To receive a bearer token, please contact us: https://meup.com/contact-us/
Request
URL
GET /public/v1/marketplace
RATE Limiting
Our API allows 60 requests per minute by default. Your key may be configured diferently.
Headers
| Key | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer YOUR_TOKEN_HERE |
Pagination
Our API will return 50 items per page. Use the page query param to change pages
GET /public/v1/marketplace?page=2
Filtering
You can include Filters as query parameters. We have listed all the available filters below.
Available Filters
| Key | Type | Format / Example | Description |
|---|---|---|---|
backlinkType |
array | backlinkType[]=guestpost |
Can be any combination of guestpost, innerpage and homepage. guestpost is an article with content provided by either the publisher or the advertiser. homepage are links placed on the home page of the publisher's website. innerpage are links placed on an inner page of the website (e.g. https://example.com/contacts) |
country |
array | country[]=US |
ISO country codes (US, IT, etc...) |
language |
array | language[]=en |
ISO language codes (en, bg, hr etc...) |
niche |
array | niche[]=CBD |
Niche names, can be Casino, Loan, Erotic, Dating, CBD, Crypto, Medicine |
domainRatingFrom |
integer | domainRatingFrom=1 |
Minimum Domain Rating to include, can range from 0 to 100 |
domainRatingTo |
integer | domainRatingTo=100 |
Maximum Domain Rating to include, can range from 0 to 100 |
domainAuthorityFrom |
integer | domainAuthorityFrom=0 |
Minimum Domain Authority to include, can range from 0 to 100 |
domainAuthorityTo |
integer | domainAuthorityTo=100 |
Maximum Domain Authority to include, can range from 0 to 100 |
authorityScoreFrom |
integer | authorityScoreFrom=0 |
Minimum Semrush Authority Score to include, can range from 0 to 100 |
authorityScoreTo |
integer | authorityScoreTo=100 |
Maximum Semrush Authority Score to include, can range from 0 to 100 |
How to use filters
Integer filters: domainRatingFrom, domainRatingTo, domainAuthorityFrom, domainAuthorityTo, authorityScoreFrom, authorityScoreTo.
To use them include them in the query like this: ?domainRatingFrom=50&domainRatingTo=100&domainAuthorityFrom=40
Array filters: backlinkType, country, language, niche.
To use them use you have to add the filter name as a query param and attach a [] at the end. You can add multiple values of the same type.
Example: ?country[]=US&country[]=BG&niche[]=Crypto&backlinkType[]=guestpost&backlinkType[]=innerpage
Example request with filters
GET /public/v1/marketplace?page=1&backlinkType[]=guestpost&niche[]=Crypto&domainRatingFrom=50&domainRatingTo=90
Response
Link Object
| Field | Type | Example | Description |
|---|---|---|---|
| id | integer | 5 | The ID of the link |
| website | object | - | A Website Object associated with the link |
| niches | array | - | Array of Niche objects supported by the link |
| price | integer | 140.0 | Price of the link |
| currency | string | USD | Currency of the price |
| backlinkType | string | guestpost | Possible values: guestpost,innerpage,homepage |
| minimumWordCount | integer/null | 800 | Minimum word count if backlink type is guestpost. null for other backlink types. |
| duration | integer/null | 12 | How long the link placement will last (in months). null if permanent |
| note | string/null | Article must be relevant to Yachts. | Publisher note for the link. null if not provided |
Website Object
| Field | Type | Example | Description |
|---|---|---|---|
| uuid | string | 58d81ec4-6c85-478e-91da-104a9b203a84 | UUID of the website |
| name | string | bloombergnews.com | Website name, without protocol (can end with /en, /blog) |
| deliveryTime | integer | 5 | Estimated link delivery time (in days). Provided by the publisher |
| languages | array | Array of Language Objects |
Languages supported by website |
| categories | array | Array of Category Objects |
Website categories |
Niche Object
| Field | Type | Example | Description |
|---|---|---|---|
| id | integer | 3 | Niche ID |
| niche | string | Crypto | Niche name |
| price | integer | 250.0 | Price for this niche |
Language Object
| Field | Type | Example | Description |
|---|---|---|---|
| code | string | en | ISO language code |
| name | string | English | Full language name |
Category Object
| Field | Type | Example | Description |
|---|---|---|---|
| id | number | 5 | Category ID |
| name | string | English | Category name |
Example Response
If the request went as expected you will receive a response in this format with status code 200.
{
"data": [
{
"id": 1,
"price": 100,
"currency": "USD",
"backlinkType": "guestpost",
"minimumWordCount": 800,
"duration": null,
"note": "Article must be relevant to Yachts.",
"website": {
"uuid": "a88ad496-69f9-4929-8c56-091d049f88ca",
"name": "bloombergnews.com",
"description": "One of the leading online news providers in with focus on political news. With over 22 millions of daily visitors you are sure to reach thousands if not millions of impressions on any post.",
"deliveryTime": 5,
"languages": [
{
"code": "en",
"name": "English"
}
],
"categories": [
{
"id": 29,
"name": "General"
},
{
"id": 35,
"name": "Lifestyle"
}
]
},
"niches": [
{
"id": 2,
"niche": "Loan",
"price": 45
},
{
"id": 5,
"niche": "CBD",
"price": 45
},
{
"id": 6,
"niche": "Crypto",
"price": 45
},
{
"id": 7,
"niche": "Medicine",
"price": 45
}
]
}
],
"meta": {
"from": 1,
"to": 10,
"total": 10,
"currentPage": 1,
"lastPage": 1,
"perPage": 50
}
}
Example Validation Error Response
Any validation errors will be returned in the following format with status code 422
{
"message": "Validation failed.",
"errors": [
"Authority Score (to) must be an integer between 0 and 100.",
"Backlink type must be one of: guestpost, innerpage, homepage."
]
}
Example Error Response
Any other request or server errors may be returned as the following message with status code 500
{
"message": "Error processing request."
}
If the rate limit is hit we will return an error message with status code 429
{
"message": "Too many requests. Please slow down."
}