Skip to content
All endpoints

Sub-80ms Search Suggest & Typeahead Autocomplete API

GET/v1/autocomplete1 Credit / query (0 if empty)($0.0001 / query ($0.06–$0.10 / 1K queries))· Updated 2026-11-14

Return real-time search query completions for any seed prefix, country, and language in under 80ms. Ideal for programmatic SEO long-tail discovery, e-commerce search boxes, and LLM RAG query fan-out.

Parameters

  • qstringrequired

    Seed query prefix to expand (e.g., 'best crm for' or 'how to migrate from').

    Example: best crm for

  • countrystring

    Two-letter ISO country code (default us).

    Example: us

  • langstring

    ISO 639-1 language code (default en).

    Example: en

  • limitinteger (1 to 20)

    Maximum number of autocomplete suggestions to return (1 to 20, default 10).

    Example: 10

Example Request (cURL / Python / JavaScript)

curl "https://api.searchdataapi.com/v1/autocomplete?q=best+crm+for" \
  -H "x-api-key: sr_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://searchdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "query": "best crm for",
    "country": "US",
    "lang": "en",
    "count": 5,
    "suggestions": [
      {
        "position": 1,
        "suggestion": "best crm for real estate agents",
        "completion_suffix": "real estate agents",
        "word_count": 6
      },
      {
        "position": 2,
        "suggestion": "best crm for small business",
        "completion_suffix": "small business",
        "word_count": 5
      },
      {
        "position": 3,
        "suggestion": "best crm for real estate",
        "completion_suffix": "real estate",
        "word_count": 5
      },
      {
        "position": 4,
        "suggestion": "best crm for mortgage loan officers",
        "completion_suffix": "mortgage loan officers",
        "word_count": 6
      },
      {
        "position": 5,
        "suggestion": "best crm for service based business",
        "completion_suffix": "service based business",
        "word_count": 6
      }
    ]
  },
  "meta": {
    "request_id": "68bd83ac-33c2-4f2f-8ef2-bf91b3a40119",
    "endpoint": "/v1/autocomplete",
    "count": 5,
    "credits_charged": 1,
    "cached": false,
    "took_ms": 46
  }
}

Response Fields

Ordered list of real-time typeahead suggestions with completion suffixes.

FieldTypeSample / Notes
codeintegerExample: 0
providerstringExample: https://searchdataapi.com
statusstringExample: ok
msgstringExample: success
dataobject
querystringInput prefix.
countrystringISO country code.
langstringISO language code.
countintegerNumber of suggestions returned.
suggestionsarray of AutocompleteItem
positioninteger1-based suggestion rank.
suggestionstringFull completed query string.
completion_suffixstringAppended suffix beyond input prefix.
word_countintegerWord count of suggestion.
metaResponseMeta
request_idstringUnique UUIDv4 trace identifier.
endpointstringNormalized /v1/* endpoint path.
countintegerNumber of primary items returned.
credits_chargedintegerCredits deducted (0 on empty or error).
cachedbooleanWhether served from L1/L2 edge cache.
took_msintegerEnd-to-end gateway latency in milliseconds.

Status Codes

200
Ordered list of real-time typeahead suggestions with completion suffixes.