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

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