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
Each item is a single link rather than a website, so the same website can appear in more than one item (for example one item per backlink type, or several links on the same site). Ordering stays consistent across pages, so you can page through the full result set and receive every link once.
Note - totals will be higher than the MeUp marketplace. This API returns every individual link as its own item. The MeUp marketplace groups links from the same website and backlink type into a single listing (with the alternatives shown as offers), so its result count is lower. Expect the
totalhere to exceed the number of listings you see on the site, and treat each item as one purchasable link, not one website.
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
Combining filter values: multiple values of the same filter widen the results, while different filters narrow them. So niche[]=Crypto&niche[]=CBD returns links offering Crypto or CBD, and adding backlinkType[]=guestpost then keeps only the guest posts among those. For language, a link matches when the website offers any of the languages you list; for country, when the website's primary country is one of the codes you list.
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."
}