Skip to main content
POST
Bulk import GEO competitors

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"

Body

application/json
rows
object[]
Required array length: 1 - 2000 elements
csv
string

Raw CSV text with a name column (optionally domain, kind, synonyms). Used when rows is omitted.

Required string length: 1 - 1048576

Response

Competitors imported successfully

imported
integer
required

Rows added as new competitors.

updated
integer
required

Rows that matched an existing competitor by name and replaced the domain, kind or synonyms they provided.

skipped
integer
required

Rows repeating a name already seen earlier in the import.

issues
object[]
required

Rows rejected while parsing CSV. Always empty for rows.

competitors
object[]
required

All tracked competitors after the import.

organization
object
required