MeUp Marketplace API

GET https://take.meup.com/public/v1/marketplace

Fetches marketplace items. Supports filtering and pagination.

Authentication

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 total here 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."
}