Tweet Claim Analysis API
This is not another tweet retrieval API. It figures out what the author actually meant by analyzing the main tweet, the quoted tweet, and the media attached to both, then returns one clear, structured intelligence object.
- What is the Tweet Claim Analysis API?
- The Tweet Claim Analysis API is a social-intelligence endpoint that reads the main tweet, its quoted tweet, and any embedded video or audio, then returns a single structured JSON object with the final claim, a search-ready query string, five classification axes, and extracted topics and named entities.
Why the Tweet Claim Analysis API?
Most tweet APIs give you post text and metadata. This one resolves meaning. It reads the main post, the quoted post, and the media evidence shared across both layers to identify the real claim, the author's intent, and the context behind it. That is the difference between collecting tweets and extracting usable intelligence.
- Intent Reconstruction Across Layers — Understands what the author really meant by combining the tweet text, quoted tweet context, and media shared in both posts.
- Claim-Centric Extraction — Goes beyond sentiment to extract the actual claim being made, normalized into a verifiable statement.
- Multimodal Media Processing — Automatically retrieves transcripts or transcribes embedded video/audio, then uses that evidence to interpret the tweet instead of treating media as decoration.
- Multi-Axis Classification — Returns claim type, intent, tone, emotion, and authority on validated taxonomies.
- Structured JSON Output — REST API returning fully validated JSON designed to power dashboards, workflows, and automated pipelines.
How It Works
Sign up and generate an API key from the VidNavigator Studio. Your key grants access to all developer endpoints.
Make a POST request to /v1/tweet/statement with any X post ID. The API handles everything else automatically.
The API fetches the tweet text, the quoted tweet, and all embedded media across both layers. It returns timestamped transcripts for every embedded video in 99+ languages.
Get back a validated JSON object containing the core claim, search-ready query, detailed analysis, topics, entities, media summaries, and five classification axes.
What You Get
| Field | Description |
|---|---|
| final_statement | Complete multi-sentence claim representing what the author means after combining tweet, quote, and media context |
| statement_query | Concise single-sentence search query derived from the claim |
| detailed_analysis | 3-5 sentence breakdown covering claim, context from the quoted tweet, media evidence, and stance |
| topics & entities | Key topics (3-8) and named entities (people, organizations, places) |
| Classification axes | claim_type, intent, tone, emotion, authority — each on a validated taxonomy |
| Media summaries | Full content summaries of any video/audio attached to the tweet and the quoted tweet |
Built for Modern Workflows
Fact-Checking & Verification
Automatically extract and normalize claims into verification-ready statements. Speed up fact-check cycles and increase coverage at scale.
Reputation & Risk Management
Detect accusations, negative narratives, and emotional spikes in real time. Build early warning systems for proactive crisis management.
AI Product Integration
Add structured social intelligence as a plug-and-play layer in your AI products. Feed LLMs, search engines, and analytics platforms.
Quickstart
Provide a Tweet ID. The API fetches the tweet, the quoted tweet, embedded media in both, and orchestrates an intelligence pipeline that reconstructs meaning from the full context.
Example Response
The output provides a multi-sentence core claim, a search-ready query, detailed analysis, media-aware context, and classification parameters across five validated axes.
Pricing
Pricing is modular and tied to extraction complexity. With VidNavigator, 1 credit = 100 video analyses.
- Main Claim Extraction: Extracting the core claim from tweet text costs 1 video analysis credit.
- Embedded Media: If the tweet includes a video, extracting claims from that media costs an additional 1 video analysis.
- Quoted Tweets: If the tweet quotes another post with media, extracting from that quoted media also costs 1 video analysis.
- Transcripts & Speech-to-Text: Transcript retrieval or STT generation is billed separately based on subtitle availability and video length.
This keeps costs predictable while scaling from simple text-only claims to full media-aware extraction.