# Keyword research: POST /v1/keywords/research

Keyword opportunities for a site, each with its intent, topic, demand and difficulty, and what to do about it.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 12 (median of 17 runs, 30 days); a lookup that finds nothing is not billed
- Answers at once.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| domain | body | string | no | A site whose rankings and search summary to read, such as example.com.; at most 253 characters |
| seed | body | string | no | A seed keyword for ideas.; at most 200 characters |
| limit | body | integer | no | 1 to 100; default 20 |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/keywords/research \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"tally.so","seed":"online form builder","limit":15}'
```

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

```json
{
  "data": {
    "domain": "tally.so",
    "seed": "online form builder",
    "broadened_seed": null,
    "partial": false,
    "failed_sections": [],
    "site": {
      "ranking_keywords": "100-1k",
      "paid_keywords": "under 10",
      "monthly_search_visits": "1k-10k"
    },
    "keywords": [
      {
        "keyword": "form online builder",
        "source": "suggestion",
        "opportunity": 78,
        "intent": "commercial",
        "demand": "10k-100k",
        "difficulty": "easy",
        "position": null,
        "cluster": "online form builder",
        "action": "Make a page that compares the options and makes your case."
      },
      {
        "keyword": "free online html form builder",
        "source": "suggestion",
        "opportunity": 58,
        "intent": "commercial",
        "demand": "1k-10k",
        "difficulty": "easy",
        "position": null,
        "cluster": "html",
        "action": "Make a page that compares the options and makes your case."
      }
    ],
    "clusters": [
      {
        "cluster": "online form builder",
        "keywords": 11
      },
      {
        "cluster": "website",
        "keywords": 5
      }
    ]
  },
  "credits_charged": 9.92,
  "request_id": "560c6fae-a58b-4a50-b9eb-059fd6531004"
}
```

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