seo/
competitor-domains

The Competitor Domains API finds domains that rank for a site's Google keywords in one country and language, with shared keyword counts, average position, overlap traffic and full search totals.

Competitor Domains API

Shared keyword overlap
Average position
Organic and paid totals
0.1 credits / result
Ready
Ready

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

README

By SocQ · Updated

Competitor Domains

Search competitors are the domains that rank in Google for the same keywords as a site in a given country and language, described by how many keywords the two share, the competitor's average position and estimated monthly visits on those keywords, and its complete organic and paid totals with position bands and ranking changes. Because the list comes from actual rankings rather than assumed rivals, it supports competitor discovery, content gap research, positioning work and market maps sorted by size.

Competitor Domains API Features

  • Rivals found through shared rankingsEach row is a domain ranking for keywords the target also ranks for, with shared_keywords_count giving the size of the overlap; the target itself is left out of the list.
  • Performance on the overlapping keywordsavg_position gives the competitor's average position on the shared keywords and shared_keywords_traffic the monthly visits it is estimated to win from them.
  • Full search profile per competitororganic and paid repeat each competitor's keyword count, estimated traffic and its US dollar cost, twelve position bands and new, up, down and lost counts.
  • Up to 1,000 competitors per marketThrough results_limit, the Competitor Domains API returns from 1 to 1,000 domains for the country and language chosen with the location and language parameters, United States and English by default.

Competitor Domains API Parameters

ParametersRequiredDescription
targetRequiredDomain or subdomain whose search competitors you want, such as notion.so; https:// and www. are removed, and a URL with a path is rejected.
location_codeOptionalNumeric code of the search country, 2840 (United States) by default; give either this or location_name.
location_nameOptionalCountry name such as Germany or United States in place of location_code; when both are present they must refer to the same country.
language_codeOptionalCode of the search language, en by default; choose one that the selected country offers.
languageOptionalLanguage name such as German or English in place of language_code; when both are present they must agree.
results_limitOptionalNumber of competing domains to return, an integer from 1 to 1000; defaults to 100.

How to Use the Competitor Domains API

Submit a domain, a market and a results_limit to the Competitor Domains API, then read the competing domains.

  1. POST {"target": "notion.so", "location_code": 2840, "language_code": "en", "results_limit": 100} to /v1/seo/competitor-domains.
  2. Poll GET /v1/tasks/{task_id} until the status turns succeeded.
  3. Read the competitors from results.items and, while has_more is true, load the following pages with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/seo/competitor-domains" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en","results_limit":100}'

# 0.1 credits per competitor, at least 3 credits per request.

Competitor Domains API Use Cases

  • Uncovering hidden search competitors: Scan the domain column the Competitor Domains API returns for sites with a high shared_keywords_count beyond your own competitor list, such as publishers, marketplaces or niche tools.
  • Choosing whose content to study first: Pick competitors that combine a large shared_keywords_count with a better avg_position than yours, then pull their ranking keywords to find topics you are missing.
  • Tiering a market by search size: Sort competitors by organic.estimated_traffic and organic.keywords_count to group them into leaders, peers and smaller players for a market map.
  • Mapping who advertises on your keywords: Filter competitors with a non-zero paid.keywords_count and compare paid.estimated_traffic to see which rivals also buy Google search ads.

Competitor Domains API Pro Tips

  • Read avg_position as the competitor's own average position on the shared keywords, then compare it with your rankings rather than treating it as yours.
  • Run the Domain Overview API on your target with the same location and language, since the Competitor Domains API leaves the target out of its list and you will want its totals on the same scale.
  • Divide shared_keywords_traffic by organic.estimated_traffic to see how much of a competitor's search traffic depends on the keywords you share; a high share marks a direct rival, a low one a broad site that touches your topic.

Beyond the Competitor Domains 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.
  • Domain Overview API — Get one domain's organic and paid Google totals for a chosen country and language, with ranking keywords, estimated traffic and its ad cost, position bands and ranking changes.
  • 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.

Competitor Domains API — FAQ

Competitor Domains API is a programmatic interface for finding the domains that compete with a site in Google search for one country and language. It returns each competitor's shared keyword count, average position and traffic on those keywords, plus its full organic and paid search totals.

A domain qualifies when it ranks for keywords that the target also ranks for in the selected market, and shared_keywords_count tells you how many. The target domain itself is excluded.

Set location_code or location_name and language_code or language to any supported market, with a language offered in that country; without them the request uses the United States and English.

They answer different questions: Competitor Domains groups sites by shared Google rankings, while Backlink Competitors groups them by shared linking domains.

Each competitor returned costs 0.1 credits, with a minimum of 3 credits per request, so up to 30 competitors cost 3 credits and the default 100 cost 10.