---
title: "Bulk import GEO competitors"
method: POST
path: "/v1/projects/{projectId}/geo/competitors/import"
tags: ["GEO"]
---

# Bulk import GEO competitors

`POST /v1/projects/{projectId}/geo/competitors/import`

Accepts either structured `rows` or raw `csv` text. Existing competitors are updated in place rather than duplicated.

## Path parameters

- `projectId` string, required

## Request body

- ImportGeoCompetitorsRequest
  - `rows` object[]
    - `name` string, required
    - `domain` string, nullable
    - `kind` 'direct' | 'indirect'
    - `synonyms` string[]
  - `csv` string — Raw CSV text with a `name` column (optionally `domain`, `kind`, `synonyms`). Used when `rows` is omitted.

## Response `200`

Competitors imported successfully

- ImportGeoCompetitorsResponse
  - `imported` integer, required
  - `updated` integer, required
  - `skipped` integer, required
  - `issues` object[], required
    - `line` integer, required
    - `message` string, required
  - `competitors` GeoCompetitor[], required
    - `id` string, required
    - `name` string, required
    - `domain` string, nullable, required
    - `synonyms` string[], required
    - `kind` 'direct' | 'indirect', required
    - `color` string, nullable, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid API key
- `402` — GEO plan or available AI credits required
- `403` — Forbidden
- `404` — Organization, project or resource not found
- `409` — Conflict
- `429` — Rate limit exceeded. This endpoint allows 10 requests per 10 minutes per organization.
- `500` — Internal server error
- `503` — Authentication or billing service unavailable

## Changes

- **2026-09-02** `fd2fc44c9208` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/competitors/import/post.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) · [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/e30de0d60cc8?raw)