API access instructions

API access to FATGRID gives you unlimited access to our entire database. It lets you get a list of guest posts and link insertion publishers on the market, prices from all sellers, and fresh site metrics from Semrush. It is a quick way to bring FATGRID data into your own tools or workflows.

API is available on the Business plan.

Key facts:

URL: https://api.fatgrid.com/api/public 
Required parameters: key, type
Available types: domain_prices, domains_list, search-domains

• domain_prices – provides SEO metrics and market offers for the exact publisher.
• domains_list – allows bulk downloading of the entire database or only publishers matching the filter parameters.
• search-domains – allows bulk checking of the list of domains to determine their availability and pricing.

API key can be found in your profile section:

General Error Responses:

1. Incorrect key

{
   "message": "Key is incorrect",
   "error": "Bad Request",
   "statusCode": 400
}

2. Incorrect type

{
   "message": "Incorrect request type",
   "error": "Bad Request",
   "statusCode": 400
}

Domain Prices

Method – GET

Required params

target – required, target to get prices

Example of request:

https://api.fatgrid.com/api/public?key=myKey&type=domain_prices&target=forbes.com

Example of response:

[
  {
           "url": "stvincenttimes.com",
           "authorityScore": 35,
           "backlinks": 16489,
           "database": "us",
           "organicTraffic": 10597,
           "refDomains": 1906,
           "totalOrganicTraffic": 17602,
           "totalTraffic": 12414,
           "bestPrice": 90,
           "currency": "USD",
           "dr": 53,
           "linkFollow": "dofollow",
            "type": "guest_post",
           "resources": [
               {
                   "resource": "collaborator.pro",
                   "type": "article",
                   "price": 90,
                   "source": "https://collaborator.pro/creator/article/view?id=328521",
                   "currency": "USD",
                   "priceUpdatedAt": "2025-07-01T13:30:16.046Z",
                   "id": "67c5ea59296f94434fda7d47",
                   "publisherType": "marketplace",
                   "nichePrices": [
                       {
                           "id": "6863e2e8c02a55cc97f2a060",
                           "niche": "finance_and_trading",
                           "price": 360,
                           "currency": "USD"
                       }
                   ]
               },
               {
                   "resource": "adsy.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 164.99,
                   "source": "",
                   "priceUpdatedAt": "2025-05-15T03:00:42.135Z",
                   "id": "67c99a6e296f94434ff2b4c6",
                   "publisherType": "marketplace",
                   "nichePrices": null
               },
               {
                   "resource": "whitepress.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 161,
                   "source": "",
                   "priceUpdatedAt": "2025-06-26T03:00:06.182Z",
                   "id": "6841a1574fb09478f5982e00",
                   "publisherType": "marketplace",
                   "nichePrices": null
               }
           ],
           "category": null,
           "id": "67c5ea4f296f94434fd9eb04",
           "bestNichePrices": [
               {
                   "id": "6863e2e8c02a55cc97f2a060",
                   "niche": "finance_and_trading",
                   "price": 360,
                   "currency": "USD"
               }
           ]
       },
]

Error responses:

1. Empty target

{
   "message": "Target is required",
   "error": "Bad Request",
   "statusCode": 400
}

Domains List

Method – GET

Required params

page – required, number of page in pagination
limit – required, limit of items, up to 500

Optional params (filters)

minPrice – minimum number of the best price
maxPrice – maximum number of the best price
minDr – minimum number of domain rating
maxDr – maximum number of authority score
minAs – minimum number of authority score
maxAs – maximum number of authority score
minRefDomains – minimum number of referring domains
maxRefDomains – maximum number of referring domains
minTotalOrganicTraffic – minimum number of total organic traffic
maxTotalOrganicTraffic – maximum number of total organic traffic
minTotalTraffic – minimum number of total traffic
maxTotalTraffic – maximum number of total traffic
minTraffic – minimum number of traffic from the top country
maxTraffic – maximum number of traffic from the top country
minOrganicTraffic – minimum number of organic traffic from the top country
maxOrganicTraffic – maximum number of organic traffic from the top country
linkFollow – type of link follow: dofollow, nofollow
type – type of publishing: guest_post, link_insertion
databases – list of databases divided by comma, e.g., us,uk,es.
List of databases below
categories – list of categories divided by comma, e.g., Lifestyle,Arts.
List of categories below
niches – list of restricted niches divided by comma, e.g. crypto,adult
List of niches below

Top country / Total organic traffic and (all channels) traffic

Top country (“database” in API) – the country with most Organic traffic
Organic traffic (top country): (“organicTraffic” in API) – Organic traffic from Top country
Total traffic (top country): (“traffic” in API) – Total traffic from Top Country (all channels)
Total organic traffic: (“totalOrganicTraffic” in API) – Organic traffic from all countries
Total traffic: (“totalTraffic” in API) – Total Traffic from all countries (all channels)

Example of request:

https://api.fatgrid.com/api/public?key=myKey&type=domains_list&page=1&limit=100

Example of response:

{
   "items": [
    {
           "url": "stvincenttimes.com",
           "authorityScore": 35,
           "backlinks": 16489,
           "database": "us",
           "organicTraffic": 10597,
           "refDomains": 1906,
           "totalOrganicTraffic": 17602,
           "totalTraffic": 12414,
           "bestPrice": 90,
           "currency": "USD",
           "type": "guest_post",
           "dr": 53,
           "linkFollow": "dofollow",
           "resources": [
               {
                   "resource": "collaborator.pro",
                   "type": "article",
                   "price": 90,
                   "source": "https://collaborator.pro/creator/article/view?id=328521",
                   "currency": "USD",
                   "priceUpdatedAt": "2025-07-01T13:30:16.046Z",
                   "id": "67c5ea59296f94434fda7d47",
                   "publisherType": "marketplace",
                   "nichePrices": [
                       {
                           "id": "6863e2e8c02a55cc97f2a060",
                           "niche": "finance_and_trading",
                           "price": 360,
                           "currency": "USD"
                       }
                   ]
               },
               {
                   "resource": "adsy.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 164.99,
                   "source": "",
                   "priceUpdatedAt": "2025-05-15T03:00:42.135Z",
                   "id": "67c99a6e296f94434ff2b4c6",
                   "publisherType": "marketplace",
                   "nichePrices": null
               },
               {
                   "resource": "whitepress.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 161,
                   "source": "",
                   "priceUpdatedAt": "2025-06-26T03:00:06.182Z",
                   "id": "6841a1574fb09478f5982e00",
                   "publisherType": "marketplace",
                   "nichePrices": null
               }
           ],
           "category": null,
           "id": "67c5ea4f296f94434fd9eb04",
           "bestNichePrices": [
               {
                   "id": "6863e2e8c02a55cc97f2a060",
                   "niche": "finance_and_trading",
                   "price": 360,
                   "currency": "USD"
               }
           ]
       },


   ],
   "meta": {
       "itemsPerPage": 1,
       "currentPage": 1,
       "hasMore": true
   }
}

Error responses:

1. Empty page

{
   "message": "Page is required",
   "error": "Bad Request",
   "statusCode": 400
}

2. Empty limit

{
   "message": "Limit is required",
   "error": "Bad Request",
   "statusCode": 400
}

3. The limit is exceeded

{
   "message": "Limit is exceeded",
   "error": "Bad Request",
   "statusCode": 400
}

Search domains

URL: https://api.fatgrid.com/api/public/search-domains
Method – POST
Payload: search – required, stringified array, example:

“[{"name":"forbes.con","price":"345"}]" 

Headers: x-api-key – required, can be copied  from the profile page

General Error responses:

1. Incorrect key

{
   "message": "Key is incorrect",
   "error": "Bad Request",
   "statusCode": 400
}

Example of request:

Example of response:

{
   "entered": 1,
   "found": 1,
   "notFound": 0,
   "notFoundItems": [],
   "spam": 0,
   "spamItems": [],
   "items": [
       {
           "url": "forbes.com",
           "bestPrice": 2824.7999999999997,
           "type": "guest_post",
           "currency": "USD",
           "resources": [
               {
                   "type": "contributor_post",
                   "resource": "prnews.io",
                   "price": 11433,
                   "source": "https://prnews.io/sites/3630-forbescom.html",
                   "currency": "USD",
                   "priceUpdatedAt": "2025-08-05T14:52:47.944Z",
                   "isOwner": false,
                   "id": "67c5eabd296f94434fdc267c",
                   "rating": "10.0",
                   "publisherType": "marketplace",
                   "nichePrices": [
                       {
                           "id": "68921ac0256c0cebac0bba27",
                           "niche": "casino",
                           "price": 11433,
                           "currency": "USD"
                       },
                       {
                           "id": "68921ac0256c0cebac0bba28",
                           "niche": "crypto",
                           "price": 11433,
                           "currency": "USD"
                       }
                   ]
               },
               {
                   "resource": "adsy.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 7957.75,
                   "source": "",
                   "priceUpdatedAt": "2025-08-06T03:00:07.795Z",
                   "isOwner": false,
                   "id": "67c99a6e296f94434ff2bd04",
                   "rating": "8.5",
                   "publisherType": "marketplace",
                   "nichePrices": []
               },
               {
                   "type": "article",
                   "resource": "Private Seller",
                   "currency": "USD",
                   "price": 2824.7999999999997,
                   "priceUpdatedAt": "2025-08-06T03:01:08.198Z",
                   "source": "",
                   "isOwner": false,
                   "id": "686f6bbec8ce909f5b11995d",
                   "rating": null,
                   "publisherType": "user",
                   "nichePrices": [
                       {
                           "id": "6892c575256c0cebac1c6228",
                           "niche": "casino",
                           "price": 4538.4,
                           "currency": "USD"
                       }
                   ],
                   "directBuy": true
               },
               {
                   "type": "article",
                   "resource": "bazoom.com",
                   "currency": "USD",
                   "price": 7650,
                   "priceUpdatedAt": "2025-07-24T03:03:06.369Z",
                   "source": "",
                   "id": "6878679ebd1d9779dc9210d2",
                   "rating": "7.5",
                   "publisherType": "marketplace",
                   "nichePrices": []
               },
               {
                   "resource": "meup.com",
                   "type": "article",
                   "currency": "USD",
                   "price": 8647,
                   "priceUpdatedAt": "2025-07-31T03:16:17.585Z",
                   "source": "",
                   "id": "688ae003a8d8ccd92f5137de",
                   "rating": null,
                   "publisherType": "marketplace",
                   "nichePrices": []
               }
           ],
           "id": "68668c060956e56047a559be",
           "dr": 94,
           "linkFollow": "nofollow",
           "sponsored": false,
           "authorityScore": 98,
           "organicTraffic": 24415000,
           "backlinks": 163327139,
           "refDomains": 1420781,
           "database": "us",
           "category": "General News",
           "totalTraffic": 97630850,
           "traffic": 65660266,
           "totalOrganicTraffic": 53634383,
           "createdAt": "2025-03-03T17:45:04.473Z",
           "bestNichePrices": [
               {
                   "id": "6892c59c256c0cebac1dcaac",
                   "niche": "casino",
                   "price": 4538.4,
                   "currency": "USD"
               },
               {
                   "id": "6892c59c256c0cebac1dcaad",
                   "niche": "crypto",
                   "price": 11433,
                   "currency": "USD"
               }
           ],
           "userPrice": null,
           "priceDifference": null,
           "tags": []
       }
   ],
   "meta": {
       "totalItems": 1,
       "itemsCount": 1,
       "itemsPerPage": 500,
       "totalPages": 1,
       "currentPage": 1
   }
}

Categories

Agriculture
Animals
Architecture & Construction
Arts
Automotive
Business
Cryptocurrency
E-commerce
Fashion & Beauty
Financial
Food & Cuisine
Gambling & Betting
Gaming
General News
Green Energy & Ecology
Health & Medicine
Hobbies & Leisure
Human Resources
Kids & Parenting
Legal
Lifestyle
Local News
Logistics
Manufacturing & Industrial
Marketing & PR
Men’s
Music & Movie
Real Estate
Religion
Science & Education
Sensitive
Sports
Technology
Trading
Transportation
Travel
Women’s

Databases:

us – United States
uk – United Kingdom
ca – Canada
ru – Russia
de – Germany
fr – France
es – Spain
it – Italy
br – Brazil
au – Australia
ar – Argentina
be – Belgium
ch – Switzerland
dk – Denmark
fi – Finland
hk – Hong Kong
ie – Ireland
il – Israel
mx – Mexico
nl – Netherlands
no – Norway
pl – Poland
se – Sweden
sg – Singapore
tr – Turkey
jp – Japan
in – India
hu – Hungary
af – Afghanistan
al – Albania
dz – Algeria
ao – Angola
am – Armenia
at – Austria
az – Azerbaijan
bh – Bahrain
bd – Bangladesh
by – Belarus
bz – Belize
bo – Bolivia
ba – Bosnia and Herzegovina
bw – Botswana
bn – Brunei
bg – Bulgaria
cv – Cabo Verde
kh – Cambodia
cm – Cameroon
cl – Chile
co – Colombia
cr – Costa Rica
hr – Croatia
cy – Cyprus
cz – Czech Republic
cd – Congo
do – Dominican Republic
ec – Ecuador
eg – Egypt
sv – El Salvador
ee – Estonia
et – Ethiopia
ge – Georgia
gh – Ghana
gr – Greece
gt – Guatemala
gy – Guyana
ht – Haiti
hn – Honduras
is – Iceland
id – Indonesia
jm – Jamaica
jo – Jordan
kz – Kazakhstan
kw – Kuwait
lv – Latvia
lb – Lebanon
lt – Lithuania
lu – Luxembourg
mg – Madagascar
my – Malaysia
mt – Malta
mu – Mauritius
md – Moldova
mn – Mongolia
me – Montenegro
ma – Morocco
mz – Mozambique
na – Namibia
np – Nepal
nz – New Zealand
ni – Nicaragua
ng – Nigeria
om – Oman
py – Paraguay
pe – Peru
ph – Philippines
pt – Portugal
ro – Romania
sa – Saudi Arabia
sn – Senegal
rs – Serbia
sk – Slovakia
si – Slovenia
za – South Africa
kr – South Korea
lk – Sri Lanka
th – Thailand
bs – Bahamas
tt – Trinidad and Tobago
tn – Tunisia
ua – Ukraine
ae – United Arab Emirates
uy – Uruguay
ve – Venezuela
vn – Vietnam
zm – Zambia
zw – Zimbabwe
ly – Libya
pa – Panama
pk – Pakistan
tw – Taiwan
qa – Qatar

Niches:

casino – Casino
finance_and_trading – Finance&Trading
crypto – Crypto
adult – Adult
dating – Dating
cbd – CBD
medicine – Medicine