Skip to main content
POST
Competitor Domains API

Competitor Domains

Find out who you are really up against in Google. Each competing domain shows how many keywords it shares with the target, its average position on those keywords and the traffic it gets from them, plus its full organic and paid search totals. The list often surfaces rivals beyond the usual names, which makes it useful for content gap analysis, positioning and market mapping.
Provide a domain in target. Choose a supported country and a language available in that country; the defaults are United States (2840) and English (en). results_limit defaults to 100 and accepts integers from 1 to 1000. Each competitor costs 0.1 credits with a minimum of 3 credits per request.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a domain in target. Choose a supported country and a language available in that country; the defaults are United States (2840) and English (en). results_limit defaults to 100 and accepts integers from 1 to 1000.

target
string
required

Domain or subdomain, such as example.com.

Minimum string length: 1
callback_url
string<uri>
language
enum<string>

Language name must be supported for the selected country.

Available options:
Albanian,
Arabic,
Armenian,
Azeri,
Bengali,
Bosnian,
Bulgarian,
Chinese (Simplified),
Chinese (Traditional),
Croatian,
Czech,
Danish,
Dutch,
English,
Estonian,
Finnish,
French,
German,
Greek,
Hebrew,
Hindi,
Hungarian,
Indonesian,
Italian,
Japanese,
Korean,
Latvian,
Lithuanian,
Macedonian,
Malay,
Norwegian (Bokmål),
Polish,
Portuguese,
Romanian,
Russian,
Serbian,
Slovak,
Slovenian,
Spanish,
Swedish,
Tagalog,
Thai,
Turkish,
Ukrainian,
Urdu,
Vietnamese
Minimum string length: 1
language_code
enum<string>
default:en

Language code must be supported for the selected country. A globally supported language can still be unavailable in a particular country.

Available options:
ar,
az,
bg,
bn,
bs,
cs,
da,
de,
el,
en,
es,
et,
fi,
fr,
he,
hi,
hr,
hu,
hy,
id,
it,
ja,
ko,
lt,
lv,
mk,
ms,
nb,
nl,
pl,
pt,
ro,
ru,
sk,
sl,
sq,
sr,
sv,
th,
tl,
tr,
uk,
ur,
vi,
zh-CN,
zh-TW
Required string length: 2 - 10
location_code
enum<integer>
default:2840

Supported country code for this SEO research endpoint. Support differs from live SERP and Keyword Search Volume; 2156 is unavailable here.

Available options:
2008,
2012,
2024,
2031,
2032,
2036,
2040,
2048,
2050,
2051,
2056,
2068,
2070,
2076,
2100,
2104,
2116,
2120,
2124,
2144,
2152,
2158,
2170,
2188,
2191,
2196,
2203,
2208,
2218,
2222,
2233,
2246,
2250,
2276,
2288,
2300,
2320,
2344,
2348,
2356,
2360,
2372,
2376,
2380,
2384,
2392,
2398,
2400,
2404,
2410,
2428,
2440,
2458,
2470,
2484,
2492,
2498,
2504,
2528,
2554,
2558,
2566,
2578,
2586,
2591,
2600,
2604,
2608,
2616,
2620,
2642,
2682,
2686,
2688,
2702,
2703,
2704,
2705,
2710,
2724,
2752,
2756,
2764,
2784,
2788,
2792,
2804,
2807,
2818,
2826,
2840,
2854,
2858,
2862
Required range: x >= 1
location_name
enum<string>

Supported country name; use either location_code or location_name.

Available options:
Albania,
Algeria,
Angola,
Argentina,
Armenia,
Australia,
Austria,
Azerbaijan,
Bahrain,
Bangladesh,
Belgium,
Bolivia,
Bosnia and Herzegovina,
Brazil,
Bulgaria,
Burkina Faso,
Cambodia,
Cameroon,
Canada,
Chile,
Colombia,
Costa Rica,
Cote d'Ivoire,
Croatia,
Cyprus,
Czechia,
Denmark,
Ecuador,
Egypt,
El Salvador,
Estonia,
Finland,
France,
Germany,
Ghana,
Greece,
Guatemala,
Hong Kong,
Hungary,
India,
Indonesia,
Ireland,
Israel,
Italy,
Japan,
Jordan,
Kazakhstan,
Kenya,
Latvia,
Lithuania,
Malaysia,
Malta,
Mexico,
Moldova,
Monaco,
Morocco,
Myanmar (Burma),
Netherlands,
New Zealand,
Nicaragua,
Nigeria,
North Macedonia,
Norway,
Pakistan,
Panama,
Paraguay,
Peru,
Philippines,
Poland,
Portugal,
Romania,
Saudi Arabia,
Senegal,
Serbia,
Singapore,
Slovakia,
Slovenia,
South Africa,
South Korea,
Spain,
Sri Lanka,
Sweden,
Switzerland,
Taiwan,
Thailand,
Tunisia,
Turkiye,
Ukraine,
United Arab Emirates,
United Kingdom,
United States,
Uruguay,
Venezuela,
Vietnam
Minimum string length: 1
results_limit
integer
default:100
Required range: 1 <= x <= 1000

Response

Task accepted

code
integer
data
object