Pull Answer Socrates data straight into your own tools, scripts or AI assistant: question research, Google and YouTube autocomplete keywords, Google Trends and keyword clustering.
Every plan includes 3 requests a month to try it, and Seneca plans and above include 500 or more, plus keyword clustering. Create a key from /account.
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 every plan. An X-Api-Key header works as an alternative to the Authorization header.
| 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 to z Autocomplete expansions. Usually hundreds of keywords in one call. | 1 request |
| GET /api/v1/youtube-keywords | q (required), gl (default US), hl (default en) | The same full keyword pull from YouTube search autocomplete: what people type into YouTube's search box, in the same groups as /keywords. Built for video and channel planning. | 1 request |
| GET /api/v1/tiktok-keywords | q (required), gl (default US), hl (default en) | The same full keyword pull from TikTok search: what people type into TikTok's search box, in the same groups as /keywords. Built for short-form video and creator work. Some countries are not covered; those return a market_unavailable warning and cost nothing. | 1 request, only when keywords come back |
| GET /api/v1/shopping-keywords | q (required), gl (default US), hl (default en), platforms (optional: google_shopping, amazon, ebay, comma separated) | Shopping searches from Google Shopping, Amazon and eBay in one call, each from that country's own site, one block per platform in the same groups as /keywords. A keyword is listed once, under the first platform that returned it. Platforms with no site for the country are listed in skipped. | 1 request for all platforms, only when keywords come back |
| 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 |
Question research:
curl "https://answersocrates.com/api/v1/keywords?q=coffee&gl=US&hl=en" \
-H "Authorization: Bearer $ANSWERSOCRATES_API_KEY"YouTube keywords:
curl "https://answersocrates.com/api/v1/youtube-keywords?q=home%20workout&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"Every key has a monthly request ceiling that renews with your billing period, plus a burst limit shared by all plans:
| Plan | Requests / period |
|---|---|
| Free | 3 / month |
| Lite | 3 / month |
| 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. Free and Lite get 3 requests a month, renewed on the 1st (UTC), and keyword clustering through the API is on Seneca and above. Team plans share one pooled quota across all members. Burst limit: 60 requests/minute per key, on every plan.
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 this: no API access at all, or keyword clustering on Free or Lite (Seneca and above). |
| 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. |
Answer Socrates also runs an MCP server, so you can use the same key to give an AI assistant live access to question research, Google and YouTube keywords, trends and clustering. No copy-pasting required.
https://answersocrates.com/api/mcpAuthorization: Bearer <your key>Claude Desktop / Claude Code config:
{
"mcpServers": {
"answersocrates": {
"type": "http",
"url": "https://answersocrates.com/api/mcp",
"headers": { "Authorization": "Bearer as_live_…" }
}
}
}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 to z Autocomplete list together. Usually hundreds of keywords. Your assistant offers this after trend research. 1 request per call.get_youtube_keywordsThe same full keyword pull from YouTube search autocomplete: what people type into YouTube's search box, for planning videos and channels. 1 request per call.get_tiktok_keywordsThe same full keyword pull from TikTok search, for short-form video and creator work. 1 request per call, nothing charged when no keywords come back.get_shopping_keywordsShopping searches from Google Shopping, Amazon and eBay in one pull, for products and ecommerce. 1 request per call for all three, nothing charged when no keywords come back.cluster_keywordsGroup a keyword list into topics and label every keyword with search intent and funnel stage (TOFU, MOFU, BOFU). 10 to 1,000 keywords per call. MCP only. Priced in cluster credits, 1 per keyword, and never spends requests.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.