API Methods: How the API Works
The LinkBuilder.com API has three main methods: two for searching websites and one for checking your usage. All requests
use your API key [уточните способ передачи ключа]. Full parameter lists and examples are in the API documentation.
1. Bulk domain search
POST /v1/search/domains
Send a list of domains and find out which of them are available for placement, with prices from every provider. Use it
to check a vendor’s offer, a competitor’s referring domains or your outreach list.
json
{
"domains": ["example.com", "forbes.com", "cnn.com"],
"limit": 500,
"sort_by": "price",
"sort_order": "asc"
}
For each website found, you get prices per provider along with the minimum and median price:
json
{
"domain": "example.com",
"prices": [
{ "provider": "Collaborator", "price": 120 },
{ "provider": "Bazoom", "price": 135 },
{ "provider": "Adsy", "price": 149 }
],
"minimum": 120,
"median": 140
}
2. Parameter search
GET /v1/search/parameters
Find websites in our database that match your criteria, without a list of domains. For example, sites in a specific
country with DR 50+ and a price under $300, excluding certain providers:
GET /v1/search/parameters
country_ids=225
ah_dr_from=50
price_to=300
exclude_provider_ids=12,17
limit=500
sort_by=price
sort_order=asc
The response includes the websites with their metrics and pricing, plus a summary of how many matches were found and
returned and how many credits were used:
json
{
"data": [
{
"domain": "example.com",
"metrics": { "ah": { "dr": 71, "traffic": 98000 } },
"pricing": {
"minimum": 95,
"median": 140,
"offers_total": 9,
"offers_returned": 5
}
}
],
"meta": { "total_found": 18432, "returned": 500, "applied_limit": 500 },
"usage": { "credits_used": 500 }
}
3. Usage
GET /v1/account/usage
Returns your current plan, used and remaining Domain Credits, the maximum number of results per request and the number
of offers per website.
Common parameters
- limit — how many websites to return. If it’s higher than your plan allows, the plan maximum is applied
automatically, without an error.
- sort_by and sort_order — sort by price or by Ahrefs, Majestic and Moz metrics, ascending or descending. Sorting is
applied before the limit, so you always get the most relevant websites.
- provider_ids — return offers only from these providers.
- exclude_provider_ids — exclude offers from these providers.
- cheapest_provider_ids — [уточните точное поведение: например, “find the cheapest offer among these providers”].
How a request is processed
1. You send a list of domains or a set of filters.
2. The API finds all matches, applies your filters and sorts the results.
3. Your plan limit is applied and the results are returned.
4. You’re charged one Domain Credit per website returned. Submitted and unmatched domains are free.
