All Tools

  1. SEORCH
  2. SEO API
  3. Questions API

Questions API

Request

Typical questions about a keyword from Google Suggest, grouped by question word – the data of the Question Tool.

https://seorch.net/api/questions/?key=YOUR_KEY&keyword=sourdough%20bread&lang=en

Parameters

ParametersRequiredMeaning
keyyesYour API key, alternatively in the X-API-Key header
keywordyesThe keyword, at most 100 characters
langnoLanguage of the question words: en (default), de, fr, es, it or pt

Response

FieldMeaning
questionsFor each question question, the detected question word word and hits: how often Google suggested the question across the individual queries. Sorted by hits
wordsNumber of questions per question word, most frequent first
totalNumber of questions
queriesNumber of Google Suggest queries (question word before and after the keyword)
Sample response, shortened
{
  "api_version": 1,
  "keyword": "sourdough bread",
  "lang": "en",
  "total": 266,
  "queries": 42,
  "words": {
    "how much": 22,
    "how long": 20,
    "how to": 20
  },
  "questions": [
    {
      "question": "sourdough bread how long does it last",
      "word": "how long",
      "hits": 3
    },
    {
      "question": "sourdough bread what is it",
      "word": "what is",
      "hits": 3
    }
  ]
}

Errors

Errors are returned as JSON with a fixed code. All APIs use missing_key and invalid_key (401), rate_limited (429) and missing or invalid parameters (400). Additionally for this API: upstream_error.

Limits

Each key allows 10 requests per minute and 500 per day. Higher limits are available on request.