Deep SEO scan (heavier analysis path) for a URL + keyword.

Deep 3-credit SEO scan with stronger competitor analysis: why a competitor outranks a URL, SERP/content-gap comparisons, related-entity density, structured-data coverage, common patterns across top-ranking pages, content briefs, and stronger strategic recommendations. Returns the full customer_v1 shape. Standard and Deep responses include structured_data_benchmarks and structured_data_coverage; Lite responses never include those fields. Deep responses MAY also include the optional serp_speed_benchmark field — head-to-head loading speed and visual stability of the target page and the top 3 organic competitors in the same SERP (LCP, CLS, approximate TBT, TTFB). Self-hosted; never calls Google PageSpeed Insights, CrUX, or Lighthouse. Clients must check for presence of optional Deep-only speed fields.

Supported region values

Pass any code from this table as region to target that country's Google SERP. The full list is also available at GET /v1/regions. googleDomain is informational only — crawls hit google.com with the gl parameter rather than the country-specific domain.

code	name	google domain	gl	default locale
US	🇺🇸 United States	google.com	us	en-US
CA	🇨🇦 Canada	google.ca	ca	en-CA
UK	🇬🇧 United Kingdom	google.co.uk	gb	en-GB
AU	🇦🇺 Australia	google.com.au	au	en-AU
NZ	🇳🇿 New Zealand	google.co.nz	nz	en-NZ
ES	🇪🇸 Spain	google.es	es	es-ES
DE	🇩🇪 Germany	google.de	de	de-DE
IT	🇮🇹 Italy	google.it	it	it-IT
FR	🇫🇷 France	google.fr	fr	fr-FR
IE	🇮🇪 Ireland	google.ie	ie	en-IE
NL	🇳🇱 Netherlands	google.nl	nl	nl-NL
CH	🇨🇭 Switzerland	google.ch	ch	de-CH
SE	🇸🇪 Sweden	google.se	se	sv-SE
NO	🇳🇴 Norway	google.no	no	nb-NO
DK	🇩🇰 Denmark	google.dk	dk	da-DK
FI	🇫🇮 Finland	google.fi	fi	fi-FI
ZA	🇿🇦 South Africa	google.co.za	za	en-ZA
MX	🇲🇽 Mexico	google.com.mx	mx	es-MX
BR	🇧🇷 Brazil	google.com.br	br	pt-BR
CO	🇨🇴 Colombia	google.com.co	co	es-CO
IN	🇮🇳 India	google.co.in	in	en-IN
SG	🇸🇬 Singapore	google.com.sg	sg	en-SG
MY	🇲🇾 Malaysia	google.com.my	my	ms-MY
JP	🇯🇵 Japan	google.co.jp	jp	ja-JP
KE	🇰🇪 Kenya	google.co.ke	ke	en-KE
AE	🇦🇪 UAE	google.ae	ae	ar-AE
HK	🇭🇰 Hong Kong	google.com.hk	hk	zh-HK

Idempotency-Keystring

Request body

urlstring uri

keywordstring required

Primary search keyword. Whitespace is normalized. Must be a concise search query: max 150 characters.

region'US' | 'CA' | 'UK' | 'AU' | 'NZ' | 'ES' | 'DE' | 'IT' | 'FR' | 'IE' | 'NL' | 'CH' | 'SE' | 'NO' | 'DK' | 'FI' | 'ZA' | 'MX' | 'BR' | 'CO' | 'IN' | 'SG' | 'MY' | 'JP' | 'KE' | 'AE' | 'HK'

Region code. Case-insensitive and trimmed on input. Use canonical uppercase codes in response bodies. See GET /v1/regions.

market'US' | 'CA' | 'UK' | 'AU' | 'NZ' | 'ES' | 'DE' | 'IT' | 'FR' | 'IE' | 'NL' | 'CH' | 'SE' | 'NO' | 'DK' | 'FI' | 'ZA' | 'MX' | 'BR' | 'CO' | 'IN' | 'SG' | 'MY' | 'JP' | 'KE' | 'AE' | 'HK'

DEPRECATED: use region. Accepted for backward compatibility; the API emits Deprecation: true + Link response headers when this field is used. Must match region if both are sent.

localestring

BCP-47 locale tag. Canonicalized via Intl.Locale (en_us → en-US; zh_hant_hk → zh-Hant-HK). Max 16 chars.

compatibility_modeboolean

Optional. Defaults to false. When true, allows budgeted browser rendering for difficult competitor pages. The target URL already receives automatic recovery when needed.

callbackMetadataobject

Example request

{
  "region": "uk",
  "market": "uk",
  "locale": "en-GB"
}

Response

Accepted

jobIdstring required

poweredBy'On-Page.ai' required

status'queued' required

request_idstring required

Deep SEO scan (heavier analysis path) for a URL + keyword.

Supported region values

Headers

Request body

Example request

Response

Changes