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
suggestionRows or suggestion_rows beside the query that produced them.
Build a search box or keyword list
UseGET /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 whentypes leaves it out.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 getWWW-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 theRetry-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?
CallGET /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?
Startq 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?
Startq 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." }