APITube Help Center

What data is included with each article?

An overview of article text, source details, and analysis fields

Tasha Tatum

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 as en.
  • translations.en.title and translations.en.description: English translations of non-English headlines and descriptions. The body is not translated, and English articles have null values 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, with id, name, relevance score, taxonomy, and a self feed link.
  • topics: more specific tags, with id, name, score, and a self link.
  • industries: business-sector tags, with id, name, and a self link.
  • 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, and type.
  • links to its APITube feed, Wikipedia, and Wikidata pages when known.
  • frequency, the number of mentions.
  • sentiment toward that subject, with positive, neutral, and negative mentions.
  • title.pos and body.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: publisher domain, home_page_url, type, political bias, rankings.opr, country details in location, and favicon.
  • 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 estimated read_time.

What media, engagement and status data is included?

  • media and links: lists of { url, type } for media and outbound links.
  • summary: key sentences, each with its own sentiment.
  • shares: total, facebook, twitter, and reddit share counts. New articles may have incomplete counts during roughly the first two hours.
  • story: an id and uri for 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.


Related Articles