seo/
domain-overview

The Domain Overview API returns a domain's organic and paid Google search totals for one country and language: ranking keywords, monthly traffic and its ad cost, position bands and ranking changes.

Domain Overview API

Organic and paid totals
Position bands 1–100
Country and language market
5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Domain Overview

A domain's search footprint is its presence in Google results for one country and language, summed up as the number of keywords it ranks for, the monthly visits those rankings are estimated to bring and what that traffic would cost in ads, split into organic and paid and spread across position bands from 1 to 100 with counts of new, rising, falling and lost rankings. One row of these totals sizes a competitor, qualifies a prospect by search presence and, saved month after month, tracks how a site's own visibility is moving.

Domain Overview API Features

  • One domain in one Google markettarget takes a domain, and location and language pick the country and language of the search results, defaulting to the United States and English; the row repeats location_code and language_code so stored snapshots stay labelled.
  • Organic and paid in the same shapeIn the Domain Overview API response, organic and paid each carry the same set of totals, so unpaid rankings and search ads can be compared field by field.
  • Traffic with its advertising valuekeywords_count counts ranking keywords, estimated_traffic gives the monthly visits they bring, and estimated_traffic_cost prices that traffic in US dollars at Google Ads rates.
  • Twelve position bandspositions splits ranking keywords into pos_1, pos_2_3, pos_4_10 and further bands up to pos_91_100, showing whether a domain wins page one or sits deeper in the results.
  • Ranking movement since the last updatenew_count, up_count, down_count and lost_count report how many keywords entered, rose, fell or dropped out of the rankings since the previous data update.

Domain Overview API Parameters

ParametersRequiredDescription
targetRequiredDomain or subdomain to analyse, such as notion.so; https:// and www. are removed, and a URL with a path is rejected.
location_codeOptionalNumeric code of the search country, such as 2840 for the United States, which is the default. Use this or location_name.
location_nameOptionalCountry name such as United States, as an alternative to location_code; if both are sent they must name the same country.
language_codeOptionalLanguage code such as en, the default; it must be one of the languages available in the chosen country.
languageOptionalLanguage name such as English, as an alternative to language_code; if both are sent they must match.

How to Use the Domain Overview API

Send a domain with its market to the Domain Overview API and read the overview row once the task completes.

  1. POST {"target": "notion.so", "location_code": 2840, "language_code": "en"} to /v1/seo/domain-overview.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the single overview row from results.items; results.next_cursor only matters when has_more is true.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en"}'

# One market per request, 5 credits.

Domain Overview API Use Cases

  • Sizing a competitor's search presence: Read organic.keywords_count and organic.estimated_traffic to see how much of a market a rival already reaches through Google.
  • Tracking your own visibility month by month: Save the positions bands and the new, up, down and lost counts from the Domain Overview API every month to chart whether rankings are climbing toward page one.
  • Qualifying agency prospects: Use organic.estimated_traffic_cost as a dollar figure for what a prospect's search traffic is worth when deciding which accounts to pursue.
  • Checking whether a site buys search ads: paid.keywords_count and paid.estimated_traffic show whether a domain runs Google search ads in the market and how much traffic they bring.
  • Comparing one site across countries: Submit the same domain to the Domain Overview API with different location and language settings to see in which markets it is strongest.

Domain Overview API Pro Tips

  • For a country where English is not offered, set language_code or language yourself, because the default en is accepted only where that country lists English.
  • Add pos_1, pos_2_3 and pos_4_10 together to get the number of keywords on the first page, since the bands are separate ranges that do not overlap.
  • Read new, up, down and lost counts as changes since the previous data update, not since your last request, and store each row with collected_at to build your own history.
  • Give the Domain Overview API the bare domain; for figures on individual pages of the site, use the Relevant Pages API, which reports ranking distributions page by page.

Beyond the Domain Overview API, use these APIs when you need a different type of public SEO data.

  • Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
  • Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
  • Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
  • Ranked Keywords API — Find keywords a domain, subdomain, or page ranks for, with matching URLs, positions, search measurements, intent, and complete source elements.
  • Competitor Domains API — Find the domains ranking for the same Google keywords as a site in one market, with shared keyword count, average position, overlap traffic and full search totals.
  • Traffic Estimate API — Estimate monthly organic and paid Google search visits and keyword counts for up to 1,000 domains in one market.

Explore other platforms

Combine SEO data with public data from other supported social platforms.

Domain Overview API — FAQ

Domain Overview API is a programmatic interface for reading a domain's Google search totals in one chosen country and language. It returns organic and paid keyword counts, estimated monthly traffic and its ad cost, rankings by position band and counts of new, rising, falling and lost keywords.

It checks search traffic: estimated_traffic is the monthly number of visits a domain is estimated to receive from Google results in the selected market, reported separately for organic and paid results.

Set the country with location_code or location_name and the language with language_code or language; the language has to be one offered in that country. Without them, the request uses the United States and English.

It is the estimated monthly cost, in US dollars, of buying the same traffic through Google Ads, which turns organic visibility into a comparable money figure.

Each request covers one domain. To compare traffic and keyword counts for a long list, the Traffic Estimate API accepts up to 1,000 domains at once.

A fixed 5 credits per request, covering one domain in one market.