Skip to main content
GET https://xquik.com/api/v1/x/search/autocomplete
limit is an upper bound for paid authenticated calls. When remaining credits cannot cover every suggestion, Xquik returns fewer. If zero suggestions are affordable, it returns 402 insufficient_credits.
1 credit per suggestion returned · All plans from $0.00012/credit
The Node.js and Python snippets build one row per suggestion. Each row keeps the query, suggestion type, search text, and display label. Store suggestionRows or suggestion_rows beside the query that produced them.

Build a search box or keyword list

Use GET /x/search/autocomplete to read what X suggests while someone types. One call returns one answer. This route has no cursor and no next page.

Typeahead

Send the text typed so far as q. Show users, topics, hashtags, and cashtags as separate groups.

Accounts only

Set types=users to resolve a partial name or handle. Follow up with Get user for the full profile.

Hashtags

Start q with #, or set types=hashtags. Each suggestion keeps its #.

Stocks and tokens

Start q with $, or set types=cashtags. Each cashtag carries price, marketCap, and dailyChangePercent.

Keyword research

Store topics for each seed term. Pass a topic to Search tweets to read matching posts.

Credit control

Set limit to cap the suggestions you pay for. A query with no suggestions costs 0 credits.

Query parameters

Choose fields

Headers

Response

200 OK

Every list keeps the order X returns. X may rank suggestions differently per request, so 2 calls can differ. A list is empty when X suggests nothing of its type. It is also empty when types leaves it out.
Example values are illustrative. Live responses reflect current X (Twitter) data.

400 Invalid request

q is missing or blank. Send the text typed so far. { "error": "invalid_params", "message": "Send types as users, topics, hashtags or cashtags, separated by commas.", "parameter": "types" } types names an unknown suggestion type. Use users, topics, hashtags, or cashtags.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

The read service returned an error. Retry after a short delay.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

The normalized v1 response contract can return 424 when the read service is unavailable.

Search autocomplete API questions

How do I get Twitter search suggestions programmatically?

Call GET /x/search/autocomplete with the text typed so far in q. Read users, topics, hashtags, and cashtags from the response.

How do I get hashtag suggestions?

Start q with #, such as #nas. You can also send types=hashtags with a plain word. Each suggestion in hashtags keeps its #.

How do I look up a stock or crypto ticker?

Start q with $, such as $tsla, and read cashtags. Use smartTag to tell a stock from tokens that share its ticker.

How much does a search autocomplete request cost?

Each returned suggestion costs 1 credit. count states the total. A query with no suggestions costs 0 credits. Errors cost 0 credits.

Does the response depend on my X account?

No. The response holds public suggestion data only. It needs no connected X account.

Does this replace X’s official API?

No. This page documents Xquik, an independent third-party service. It does not document X’s official API.
Next steps. Search users for full profiles with filters. Search tweets to read posts for a suggestion. Get trends for trending topics by region.

Response examples

  • 400 { "error": "missing_query", "message": "Search query required. Use q." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 424 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }