# Find a site's search competitors: POST /v1/competitors/discover

The sites competing with a domain in search, with how much they overlap and how far they reach.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 3 per lookup
- Answers at once.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| domain | body | string | yes | The site whose search rivals to find, such as example.com.; at most 253 characters |
| limit | body | integer | no | 1 to 50; default 10 |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/competitors/discover \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"tally.so","limit":6}'
```

## Response (a real call, 2026-11-11, trimmed)

```json
{
  "data": {
    "domain": "tally.so",
    "competitors": [
      {
        "domain": "jotform.com",
        "overlap": 58,
        "standing": "ranks_higher",
        "search_reach": "100k+"
      },
      {
        "domain": "typeform.com",
        "overlap": 45,
        "standing": "about_even",
        "search_reach": "10k-100k"
      },
      {
        "domain": "forms.app",
        "overlap": 37,
        "standing": "ranks_lower",
        "search_reach": "10k-100k"
      }
    ],
    "site": {
      "search_reach": "1k-10k"
    },
    "note": null
  },
  "credits_charged": 3.2,
  "request_id": "1a18e09d-3822-41fd-9215-e7cf988cff42"
}
```

The whole API reference, for an agent: https://magistermarketing.com/docs/api.md