POST https://xquik.com/api/v1/x/analysis/news
2 credits per analyzed post · All plans from $0.00012/credit · Supports guest paid reads
POST /api/v1/x/analysis/news.
Name the topic in
analysis.targets. The answers classify what a post says.
They do not check whether its claims are true.
Name the topic
Put the topic inanalysis.targets, with its other names as aliases. A topic
can be an event, company, person, ticker, or product.relevance. Posts about the same industry, competitors, or the wider market do
not count. Filter rows on relevance before you count answers.Read the news answers
results[].answers holds each decision by question ID.attribution says whether a source is given. It does not rate the source.Separate reports from rumors
Keepreporting with named or linked attribution for sourced news. Watch
speculation with absent attribution for rumors that spread without a
source.
analysisSummary.questions.format.shares holds each format’s share of posts.
Store it per run to see when speculation outgrows reporting.Track the sources
results[].sourceDomains lists the sites each post links to. The summary’s
sourceDomains counts posts per site, most posts first, up to 20.
For more posts than 1 call returns, send the same body again. Add cursor
set to next_cursor. Add sinceTime and untilTime to read 1 day or 1 hour.Pick the posts to analyze
SendtweetIds, texts, a page, or a search, never more than 1. See pick the posts to analyze for each source.Compare with an earlier answer
Send theresults of an earlier call as baseline to see what changed. The comparison costs nothing extra. See compare with an earlier answer for an example.Budget the analysis
Each analyzed post costs 2 credits. Each text intexts costs the same. Posts in unanalyzed cost nothing. See budget the analysis for each reason.Body
See body parameters for every field. Common ones aretweetIds, texts, query, username, and limit.Headers
Response
200 OK
400 Invalid input
{ "error": "invalid_input", "message": "Send tweetIds, texts, or a search such as query or username." }
The body names no posts or names more than 1 source. A body with an invalid field gets the same error.
The message says what to send instead. The request costs nothing.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
Missing or invalid API key. Check the x-api-key header value.402 Payment required
Full account keys can receiveno_subscription, subscription_inactive, no_credits, or insufficient_credits with account payment options. Guest keys receive only the guest top-up action.
The failed request creates no checkout. Ask the user to confirm before calling any checkout or top-up route.403 Protected account
{ "error": "x_account_protected" }
A search that needs a protected author returns this. Choose a public account.
The request costs nothing.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
Xquik is busy. Wait for theRetry-After header, then send the request again.
The request costs nothing.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.News monitoring API questions
How do I monitor news about a topic on X?
Search the topic inquery and name it in analysis.targets. Each row in
results holds the post’s format, attribution, and relevance.Does it check whether a post is true?
No. The answers say what kind of post it is. They also say whether the post names a source. They do not verify claims or rate the source.How do I find rumors?
Keep rows whoseformat is speculation. Rows with absent attribution give
no source for their claims.Can I follow 1 outlet or reporter?
Yes. Send their handle inusername, and name your topic in
analysis.targets.How much does news classification cost?
Each analyzed post costs 2 credits. Posts inunanalyzed and refused requests
cost nothing.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. Market signals reads stock and crypto stances, or Classify posts asks your own questions.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 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." }