---
title: "Bulk Add Competitors"
method: POST
path: "/radar/competitors/bulk"
tags: ["Radar"]
---

# Bulk Add Competitors

`POST /radar/competitors/bulk`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/radar/competitors/bulk`
- Auth: HTTP bearer

Add many competitors at once (normalize + dedup + 20-competitor cap).

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- BulkCompetitorsRequest
  - `competitors` BulkCompetitorItem[]
    - `domain` string, required
    - `name` string, nullable
    - `tier` string, nullable
    - `scan_config` ScanConfigDTO: Per-competitor page-selection config (persisted on profile.meta.scan_config). mode=auto: Firecrawl /map → rank by traffic + pricing/feature paths → scrape top N (= tier page budget). mode=manual: scrape include_paths (literal or /wildcard/* patterns), capped to the budget.
      - `mode` 'auto' | 'manual'
      - `include_paths` string[]
  - `scan_on_add` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)