What data is included with each article?
An overview of article text, source details, and analysis fields
Written by Tasha Tatum
July 5, 2026
Updated October 16, 2026
What data is included with each article?
Each APITube article includes its headline, body, source, publication time, and original URL. It also includes topics, named subjects, sentiment, reading-difficulty scores, media, and other details you can use in your app.
This guide explains what the groups of fields are for. See what’s inside a news article for a JSON example.
What content and identity fields does each article include?
Start with the article’s main content:
title: headline.description: a short summary without HTML.body: plain text.body_html: the same article with HTML formatting.href: original article URL.image: lead image URL.published_at: publication time in ISO 8601 UTC.language: a language code such asen.translations.en.titleandtranslations.en.description: English translations of non-English headlines and descriptions. The body is not translated, and English articles havenullvalues here. See languages and translation.author:{ id, name }when a byline is available.
What classification data does APITube attach?
These fields describe subjects:
categories: IPTC Media Topics, withid,name, relevancescore,taxonomy, and aselffeed link.topics: more specific tags, withid,name,score, and aselflink.industries: business-sector tags, withid,name, and aselflink.keywords: important words and phrases.
Category and topic scores indicate relevance. Feed links let you find more articles with the same label.
What entity and knowledge-graph data is included?
entities lists named subjects. The nine types are person, location, organization, brand, product, natural-disaster, disease, event, and sport.
Each can include:
id,name, andtype.linksto its APITube feed, Wikipedia, and Wikidata pages when known.frequency, the number of mentions.sentimenttoward that subject, with positive, neutral, and negativementions.title.posandbody.pos, showing where the name appears.metadata, such as headquarters and key people for known organizations.
locations_mentioned provides place name, country, lat, and lng in a simpler list for maps. See understanding entities.
What sentiment data comes with each article?
Read sentiment.overall, sentiment.title, and sentiment.body for article, headline, and body tone. Each includes a -1 to 1 score and a positive, negative, or neutral label.
An entity’s own sentiment describes tone toward that person or company. It can differ from overall tone. See how sentiment analysis works.
What source, quality and readability data is included?
source: publisherdomain,home_page_url,type, politicalbias,rankings.opr, country details inlocation, andfavicon.readability:flesch_reading_ease,flesch_kincaid_grade,automated_readability_index,difficulty_level,target_audience,reading_age, and average word and syllable measurements.- Length:
words_count,sentences_count,paragraphs_count,characters_count, and estimatedread_time.
What media, engagement and status data is included?
mediaandlinks: lists of{ url, type }for media and outbound links.summary: key sentences, each with its own sentiment.shares:total,facebook,twitter, andredditshare counts. New articles may have incomplete counts during roughly the first two hours.story: anidandurifor related coverage.is_breaking: marks important breaking news.is_duplicate: an approximate near-copy flag, rather than a complete record of all reprints.is_free: whether the original article is freely readable at its publisher. It does not describe your APITube subscription.
Common Questions
Is the data the same on every endpoint?
Search, single-article lookup, and streaming use the same article field names and structure. Unavailable values can be empty arrays, null, or 0.
Do I have to receive all of this data?
No. Choose fields with fl, such as fl=id,title,source.domain,sentiment.overall. See how to select specific response fields.
Why is some data shortened on the free plan?
Free plans and test keys return previews of body and body_html. Descriptions, article links, images, and source URLs stay complete. The field structure remains the same. Use a live key on a paid plan for full article text.