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
| Parameters | Required | Description |
|---|---|---|
target | Required | Domain 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_code | Optional | Numeric code of the search country, 2840 (United States) by default; give either this or location_name. |
location_name | Optional | Country name such as Germany or United States in place of location_code; when both are present they must refer to the same country. |
language_code | Optional | Code of the search language, en by default; choose one that the selected country offers. |
language | Optional | Language name such as German or English in place of language_code; when both are present they must agree. |
results_limit | Optional | Number 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.
- POST {"target": "notion.so", "location_code": 2840, "language_code": "en", "results_limit": 100} to /v1/seo/competitor-domains.
- Poll GET /v1/tasks/{task_id} until the status turns succeeded.
- 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.
Related APIs
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.
- 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