USusenotra
GEO

Bulk import GEO competitors

Changed on

Accepts either structured rows or raw csv text. Existing competitors are updated in place rather than duplicated. One request takes a project's whole list (up to 2,000 competitors), so send it in a single call instead of splitting it.

post/v1/projects/{projectId}/geo/competitors/import

Request

  • Base URL
    https://api.usenotra.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required
Example:b1f2c3d4-0000-4000-8000-000000000000

Request body

csvstring

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

Response

Competitors imported successfully

importedinteger required

Rows added as new competitors.

updatedinteger required

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

skippedinteger required

Rows repeating a name already seen earlier in the import.

Changes