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
| Parameters | Required | Description |
|---|---|---|
target | Required | Domain or subdomain to analyse, such as notion.so; https:// and www. are removed, and a URL with a path is rejected. |
location_code | Optional | Numeric code of the search country, such as 2840 for the United States, which is the default. Use this or location_name. |
location_name | Optional | Country name such as United States, as an alternative to location_code; if both are sent they must name the same country. |
language_code | Optional | Language code such as en, the default; it must be one of the languages available in the chosen country. |
language | Optional | Language 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.
- POST {"target": "notion.so", "location_code": 2840, "language_code": "en"} to /v1/seo/domain-overview.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API