API access instructions

What you can access

The FatGrid API gives programmatic access to our full database of domains with link placement pricing. All data is updated continuously.

The API is available to all FatGrid users.

• Free Plan / Pro Plan — 1 unit is charged per domain request
• Business Plan — unlimited API usage

Where to find your API key

You can find your API key in Profile settings → General section

Authentication

Every GET request requires a key query parameter. POST requests use an x-api-key header. Copy your API key from the profile page in your FatGrid account.

Base URL for all endpoints: https://api.fatgrid.com/api/public

# GET request (add key= to every request)
GET https://api.fatgrid.com/api/public?key=YOUR_KEY&type=...

# POST request (x-api-key header)
POST https://api.fatgrid.com/api/public/search-domains
x-api-key: YOUR_KEY

1. Domains List

Returns a paginated list of domains available for guest posts or link insertions, with full pricing and metrics. This is the most used endpoint — ideal for bulk inventory pulls and filtered searches.

Required parameters

• key — your API key
• type — must be domains_list
• page — page number, starting at 1
• limit — domains per page, maximum 500

Optional filter parameters

• minPrice / maxPrice — price range in USD
• minDr / maxDr — Domain Rating range (0–100)
• minAs / maxAs — Authority Score range (0–100)
• minTotalOrganicTraffic / maxTotalOrganicTraffic — monthly organic traffic
• createdAtFrom / createdAtTo — domain creation date in ISO 8601 format (e.g. 2022-01-01)
• linkFollow — dofollow or nofollow
• offerType — guest_post or link_insertion
• sponsored — true or false (exclude sponsored listings)
• categories — comma-separated category names
• niches — restrict to niche-accepting domains: casino, crypto, adult, dating, cbd, medicine, finance
• resources — filter by marketplace name, e.g. collaborator.pro
• languages — comma-separated language codes, e.g. en,es,fr
• databases — country/region database code, e.g. us, uk, ca (see reference section for full list)

# Basic request — first page, 100 domains
GET https://api.fatgrid.com/api/public?key=YOUR_KEY&type=domains_list&page=1&limit=100

# Filtered — dofollow guest posts with DR 40–70
GET https://api.fatgrid.com/api/public?key=YOUR_KEY&type=domains_list&page=1&limit=500
  &offerType=guest_post&linkFollow=dofollow&minDr=40&maxDr=70

Response fields

Each item in items contains:

• id — internal domain ID
• url — domain name
• dr — Domain Rating (Ahrefs)
• authorityScore — Authority Score (Semrush)
• backlinks — total backlink count
• refDomains — referring domain count
• bestPrice — lowest available price across all marketplaces
• currency — price currency (always USD)
• traffic — session count
• organicTraffic — organic search traffic
• totalOrganicTraffic — total organic traffic
• minMonthlyOrganicTraffic — minimum monthly organic traffic
• totalTraffic — combined traffic figure
• databases — country/region database code
• linkFollow — dofollow or nofollow
• type — offer type: guest_post, link_insertion, or both
• title — site title (may be null)
• language — primary language of the site
• sponsored — whether the listing is sponsored
• categories — array of category strings
• createdAt — date the domain first appeared in the database
• isReachable — whether the domain passed a reachability check (present when the linkFollow filter is applied)

Each domain also includes a resources array with per-marketplace pricing. Each resource has:

• id — resource listing ID
• resource — marketplace name
• type — offer type on this marketplace
• price — listed price
• currency — price currency
• directBuy — whether direct purchase is available
• isOwner — whether FatGrid owns this listing
• publisherType — publisher classification
• rating — marketplace rating score
• priceUpdatedAt — when this price was last refreshed
• source — direct URL to the listing on the marketplace (present for some marketplaces)
• nichePrices — array of niche-specific prices, each with id, niche, price, currency

Pagination fields in the response root:

• currentPage — current page number
• itemsPerPage — items returned per page
• hasMore — true if more pages remain
• totalItems — total number of domains matching your filters

# Paginate through the entire guest post inventory (all domains)
page = 1
all_domains = []

while True:
    url = f"https://api.fatgrid.com/api/public?key=YOUR_KEY"
          f"&type=domains_list&page={page}&limit=500&offerType=guest_post"
    data = requests.get(url).json()
    all_domains.extend(data["items"])
    if not data["hasMore"]:
        break
    page += 1

print(f"Total: {len(all_domains)} domains")

2. Domain Prices

Returns all marketplace listings for a single domain. Returns an empty array if the domain has no listings.

Required parameters

• key — your API key
• type — must be domain_prices
• target — the domain name to look up

The response is an array. Each item has the same fields as the domains_list endpoint (url, dr, bestPrice, resources, etc.). Returns [] if the domain is not in the database.

GET https://api.fatgrid.com/api/public?key=YOUR_KEY&type=domain_prices&target=example.com

3. Search Domains (Batch Lookup)

Check a list of specific domains in a single request. Returns found domains with full pricing, marks missing and spam domains separately. Accepts up to 500 domains per request.

Method: POST
URL: https://api.fatgrid.com/api/public/search-domains
Header: x-api-key: YOUR_KEY
Content-Type: application/json

Request body

• search — comma-separated string of domain names

POST https://api.fatgrid.com/api/public/search-domains
x-api-key: YOUR_KEY
Content-Type: application/json

{
  "search": "domain1.com,domain2.com,domain3.com"
}

Response fields

• entered — number of domains in the request
• found — number of domains found in the database
• notFound — number of domains not found
• notFoundItems — array of domain names not in the database
• spam — number of blacklisted/spam domains
• spamItems — array of spam domain names
• items — array of found domain objects (same fields as domains_list)
• meta — pagination metadata: totalItems, itemsCount, itemsPerPage, totalPages, currentPage

4. Marketplaces List

Returns the list of all integrated marketplaces and their last data refresh timestamp. Use this to verify data freshness.
For Free Plan and Pro Plan users, this request does not consume any units.

Required parameters

• key — your API key
• type — must be marketplaces_list

The response contains an items array and a total count. Each item has a name (marketplace domain) and fetchedAt (last update timestamp).

GET https://api.fatgrid.com/api/public?key=YOUR_KEY&type=marketplaces_list

Error responses

All errors return JSON with message, error, and statusCode fields.

• Missing or invalid key — 400, message: "key must be a string"
• Invalid type value — 400, message lists the three valid values: domain_prices, domains_list, marketplaces_list
• Missing required parameter — 400, message names the missing field
• Limit exceeds 500 — 400, message: exceeded limit
• Invalid API key — 401 Unauthorized

No units on your balance -

{"message":"Insufficient units. Please top up your balance.","error":"Bad Request","statusCode":400}

Reference data

Integrated marketplaces

adsy.com, backlinked.com, bazoom.com, collaborator.pro, ereferer.com, guestpostlinks.net, linkatomic.com, linkpublishers.com, linksmanagement.com, meup.com, prnews.io, prposting.com, serpzilla.com, whitepress.com

Restricted niches (7)

casino, finance, crypto, adult, dating, cbd, medicine

Use these exact values in the niches filter parameter to find domains that accept content in these categories.

Country/region database codes (50+)

Americas: us, ca, br, mx, ar, cl, co, pe, ve, ec, bo, py, uy, cr, gt, hn, sv, ni, pa, do, cu, pr, jm, tt, ht
Europe: uk, de, fr, es, it, pl, nl, ru, ua, ro, cz, hu, bg, hr, rs, sk, si, lt, lv, ee, fi, se, no, dk, pt, gr, tr, be, ch, at, ie, by
Asia-Pacific: au, nz, in, jp, kr, cn, sg, my, ph, th, id, vn, hk, tw, pk, bd, lk
Africa and Middle East: za, ng, ke, gh, eg, ae, il, sa