DocumentationAPI & MCP

Getting started

Create a key, make your first call and read the answers.

Everything you do in semchat, from your own code (the API) or from your AI assistant (MCP): your sites, their analysis, action plans, keywords, competitors, backlinks, documents, scheduled tasks and the semchat chat. The same actions as in the app, at the same prices.

Get a key

  1. 1Open Settings → API & MCPIn your workspace, in semchat. Only the owner and admins create and revoke keys.
  2. 2Create a keyGive it a name, then copy it: it is shown only once.
  3. 3Revoke it if it leaksRevoke, in the same tab: the key stops working at once.
A key acts on the whole workspace. Keep it on a server, never in a public site or app.
Settings › API & MCP: the keys, the MCP server and the setup for each assistant

Authentication

Every request carries the key in the Authorization: Bearer header (or X-API-Key). The base URL is https://app.semchat.io/api/v1. Bodies and answers are JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Without a valid key, the answer is a 401: see Errors and limits.

A first site

Create a site and start its analysis in the same call. The analysis is billed; needs_credits says when the credits could not pay for it.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Then read its action plan with List todos, or ask the chat about it with Send site message.

Answers

  • An answer is { "data": … }: one object, or a list with every item.
  • Dates are ISO 8601 in UTC, and ids are UUIDs.
  • Credits never appear as raw numbers, only as a share of the period: Get workspace, Get usage.

What a key can see

A key belongs to one workspace: it sees that workspace’s sites and conversations and nothing else, and it acts with the rights of the member who created it.

The OpenAPI document

The whole reference as OpenAPI 3.1, to import into Postman, Insomnia or a client generator: openapi.json.

A question this doesn’t answer? Write to us.

Ready to get your site off the ground?

Ask your first question - semchat replies with a clear action plan in seconds.

Free · no sign-up · takes 5 seconds