API & MCP

Pull Answer Socrates data — question research, autocomplete keywords and Google Trends — straight into your own tools, scripts or AI assistant.

API access is included on Seneca plans and above. Create a key from /account.

Authentication

Send your API key as a bearer token on every request:

Authorization: Bearer as_live_…

Keys are created on the Account page and are available on Seneca plans and above. An X-Api-Key header works as an alternative to the Authorization header.

Endpoints

Endpoint	Params	Description	Quota cost
GET /api/v1/keywords	q (required), gl (default US), hl (default en)	The full keyword pull for a seed term: Questions, Prepositions, Comparisons and time-based groups, plus the raw a–z Autocomplete expansions — usually 500-900 keywords in one call.	1 request
GET /api/v1/rising-topics	q (required), gl (default US)	Topic discovery: related searches around a seed, split into rising (breakouts) and top (established).	1 request
GET /api/v1/trends	q (required), gl (default US)	12-month Google Trends interest-over-time series for a query.	1 request
GET /api/v1/usage	none	Current plan, quota ceilings and usage so far this billing period.	free — does not count against quota

Examples

Question research:

curl "https://answersocrates.com/api/v1/keywords?q=coffee&gl=US&hl=en" \
  -H "Authorization: Bearer $ANSWERSOCRATES_API_KEY"

Quota check:

curl "https://answersocrates.com/api/v1/usage" \
  -H "Authorization: Bearer $ANSWERSOCRATES_API_KEY"

Quotas & rate limits

Every key has a monthly request ceiling that renews with your billing period, plus a burst limit shared by all plans:

Plan	Requests / period
Pro (Seneca)	500 / month
Agency (Aurelius)	2,500 / month
Senate	25,000 / month

Quotas renew with your billing period — annual plans get 12× the monthly allowance per yearly period. Team plans share one pooled quota across all members. Burst limit: 60 requests/minute per key, on every plan.

Error envelope

Every error response — REST or MCP — shares the same shape:

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API quota exceeded for the Pro plan. ..."
  },
  "request_id": "b3f1c2..."
}

Code	HTTP status	Meaning
bad_request	400	Missing or invalid parameters.
unauthorized	401	Missing, malformed or revoked API key.
plan_not_eligible	403	The account's plan doesn't include API access (Pro/Agency only).
rate_limited	429	More than 60 requests/minute from this key. Retry after a short backoff.
quota_exceeded	429	The monthly request quota for the plan has been used up.
service_disabled	503	The API is temporarily disabled (maintenance/rollout).
internal_error	500	Something went wrong on our end. Safe to retry.

Connect Answer Socrates to Claude, Cursor or ChatGPT

Answer Socrates also runs an MCP server, so you can use the same key to give an AI assistant live access to question research, autocomplete keywords and trends — no copy-pasting required.

Server URL: https://answersocrates.com/api/mcp
Transport: Streamable HTTP
Header: Authorization: Bearer <your key>

Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "answersocrates": {
      "type": "http",
      "url": "https://answersocrates.com/api/mcp",
      "headers": { "Authorization": "Bearer as_live_…" }
    }
  }
}

Tools

get_trends12-month interest-over-time for any keyword. Built for comparing whole baskets of terms — ask your assistant "what's rising in <niche>?" and watch it rank breakouts. 1 request per keyword.
get_rising_topicsTopic discovery — related searches around a seed split into rising breakouts and established top queries. The fastest way to find sub-topics and fresh seeds. 1 request per call.
get_keywordsThe full keyword pull in one request: Questions, Prepositions, Comparisons and the a–z Autocomplete list together — usually 500-900 keywords. Your assistant offers this after trend research. 1 request per call.
get_usageCurrent plan, quota ceilings, usage so far this billing period. Free to call.
list_projects / create_project / save_to_projectBridge research into the app: browse your team's projects, create one, and save keyword lists so they appear for the whole team. All free — archiving and deleting stay in the app.