Skip to main content
GET
Suggest GEO competitors for a domain

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Path Parameters

projectId
string
required
Minimum string length: 1
Pattern: ^[A-Za-z0-9_-]{1,100}$
Example:

"b1f2c3d4-0000-4000-8000-000000000000"

Query Parameters

domain
string
required

Website domain, for example example.com.

Required string length: 1 - 128
Example:

"example.com"

Response

Competitor suggestions fetched successfully

domain
string
required

Website domain the suggestions are for.

field
string | null
required

Market or category the lookup placed the website in, or null when it reported none.

competitors
object[]
required

Suggested competitors, deduplicated by domain or name. Nothing is saved; track one with PUT /v1/projects/{projectId}/geo/competitors.

organization
object
required