Changelog

INFO

The APITube platform is updated regularly with new features, improvements, and bug fixes. This page lists the changes made to the platform.

1.0.31

✅ ⭐ [News API] Add Social Shares - new object in article response with social media sharing metrics:
- shares.total - total number of shares across all platforms
- shares.facebook - number of Facebook shares
- shares.twitter - number of Twitter/X shares
- shares.reddit - number of Reddit shares
✅ ⭐ [News API] Add Social Shares Sorting - new sorting parameters:
- shares.facebook.min / shares.facebook.max - sort by Facebook shares
- shares.twitter.min / shares.twitter.max - sort by Twitter shares
- shares.reddit.min / shares.reddit.max - sort by Reddit shares

Note: Social share scores are aggregated gradually over 2 hours from the article's publication time. Newly published articles will show lower share counts that increase progressively until reaching their full values after 2 hours.

1.0.30

✅ ⭐ [News API] Add Solr-style Date Math - comprehensive relative date syntax for all datetime parameters:
- NOW keyword: NOW returns current time, NOW+1DAY, NOW-1WEEK for offsets
- Truncation/Rounding: NOW/DAY (start of today), NOW/MONTH (start of month), NOW/YEAR (start of year)
- Combined: NOW-1DAY/DAY (start of yesterday), NOW+1MONTH/MONTH (start of next month)
- Short aliases: 1w (1 week ago), 2m (2 months ago), 3d, 4h, 5y
- Direction modifiers: +1w (future), -2m (past, explicit)
- Full units: 1WEEK, 2MONTHS, 3DAYS, 24HOURS, 1YEAR
- Works with published_at.start, published_at.end, compare_window, and facet.range.gap
- Examples: published_at.start=NOW-7DAYS, published_at.start=NOW/WEEK, compare_window=1w

1.0.29

✅ ⭐ [News API] Add new endpoint /v1/news/trends - get trending values for a specific field, ranked by article count. Discover the most popular entities, categories, topics, industries, sources, countries, languages, and authors across your filtered result set.
- field - the field to aggregate trends on. Allowed fields: source.id, category.id, topic.id, industry.id, entity.id
- limit - number of top results to return (default: 10, max: 100)
- Enriched results with names and metadata for entity, category, topic, industry, source, country, language, and author fields

1.0.28

✅ ⭐ [News API] Add Geo-location Search - comprehensive geographic filtering for location-based content discovery:
- Circle Search - filter by radius around coordinates:
  - location.lat - latitude coordinate (e.g., 52.52 for Berlin)
  - location.lng - longitude coordinate (e.g., 13.40 for Berlin)
  - location.radius - search radius in kilometers (e.g., 50 for 50km radius)
  - location.radius.min - minimum radius for ring search (exclude inner circle)
  - location.radius.max - maximum radius for ring search
- Bounding Box Search - filter within rectangular areas:
  - location.bbox - format: minLat,maxLat,minLng,maxLng (e.g., 40.0,45.0,-74.0,-73.0 for NYC area)
- Geolocation Presence Filter - filter by coordinate availability:
  - has_location_geo=1 - only articles with coordinates
  - has_location_geo=0 - only articles without coordinates
- Example: /v1/news?location.lat=52.52&location.lng=13.40&location.radius=50
- Perfect for local news aggregation, regional event tracking, and location-based content discovery

1.0.27

✅ ⭐ [News API] Add Media Richness Sorting - new sort.by=media_richness parameter to sort articles by total media content:
- Calculates combined score of images and videos (ar_media_images_count + ar_media_videos_count)
- Perfect for finding visually rich content for social media, newsletters, or content curation
- Use with sort.order=desc to get the most media-rich articles first
✅ ⭐ [News API] Add Content Length Convenience Filters - quickly filter articles by reading time categories:
- is_quick_read=1 - articles with read time ≤ 2 minutes (news briefs, updates)
- is_medium_read=1 - articles with read time 3-7 minutes (standard articles)
- is_deep_dive=1 - articles with read time ≥ 10 minutes (in-depth analysis, long-form journalism)
✅ ⭐ [News API] Add High Quality Content Filter - is_high_quality parameter to find premium content:
- is_high_quality=1 - combines multiple quality signals: not a duplicate, source rank ≥ 5, has images, has identified author
- Ideal for editorial curation, premium content feeds, and quality-focused applications

1.0.26

✅ ⭐ [News API] Add Clickbait Detection Filter - is_clickbait parameter to identify articles where headline sentiment significantly differs from content:
- is_clickbait=1 - find articles where title polarity differs from body AND title has strong sentiment (|score| > 0.5)
- is_clickbait=0 - find articles with consistent headline-to-content sentiment
- Useful for detecting sensationalized headlines, misleading titles, and emotional manipulation
✅ ⭐ [News API] Add Sentiment Gap Filter - measure the difference between title and body sentiment scores:
- sentiment_gap.min - minimum gap between title and body sentiment (0-2 range)
- sentiment_gap.max - maximum gap between title and body sentiment (0-2 range)
- Enables precise filtering for editorial consistency analysis and content quality assessment

1.0.25

✅ ⭐ [News API] Add Readability Filters - filter articles by reading difficulty and target audience:
- Flesch-Kincaid Grade: readability.fk_grade, readability.fk_grade.min, readability.fk_grade.max - filter by US grade level (0-30)
- Flesch Reading Ease: readability.ease, readability.ease.min, readability.ease.max - filter by ease score (0-100, higher = easier)
- Automated Readability Index: readability.ari, readability.ari.min, readability.ari.max - filter by ARI score
- Difficulty Level: readability.difficulty - filter by beginner, intermediate, advanced, expert
- Target Audience: readability.audience - filter by children, general, professional, academic
- Reading Age: readability.age, readability.age.min, readability.age.max - filter by recommended reader age (6-22)
- Convenience filters: is_easy_read (FRE ≥ 60), is_difficult_read (FRE < 40)
✅ ⭐ [News API] New readability object in article response with all readability metrics

1.0.24

✅ ⭐ [News API] Add 12 new media filters for advanced image content discovery:
- Orientation filters: is_landscape_media, is_portrait_media - filter by image orientation
- Resolution filters: has_fullhd_images (1920px+), has_4k_images (3840px+), has_mobile_optimized_images (320-800px)
- Social media ready: is_instagram_ready (1080px+, square/4:5 ratio), is_twitter_card_ready (800px+, landscape)
- Content filters: has_multiple_images (2+ images), has_thumbnail (small images ≤300px), has_social_share_image (Open Graph compatible: 1200x630+)
- Quality filters: has_consistent_image_sizes (uniform image sizes, variance <200px)
- Mixed content: has_mixed_media (articles with both images and videos)

1.0.23

✅ ⭐ [News API] Add 5 new facet fields:
- content.length - categorize articles by length (short, medium, long)
- published.weekday - distinguish weekday vs weekend articles
- published.time_of_day - group by time of day (morning, afternoon, evening, night)
- sentiment.strength - classify sentiment intensity (strong, moderate, neutral)
- entity.id - facet by entity ID for entity distribution analysis

1.0.22

✅ ⭐ [News API] Add Range Facets support - create histogram-style bucketed counts for numeric and date fields. Perfect for building date-based timelines, sentiment distribution charts, and reading time analytics.
✅ ⭐ [News API] Range Facet parameters:
- facet.range - Enable/disable range faceting
- facet.range.field - Field to create ranges on (published_at, sentiment.overall.score, read_time, etc.)
- facet.range.start - Start value for range
- facet.range.end - End value for range
- facet.range.gap - Gap/interval between ranges (e.g., +1DAY, +1WEEK, 0.1 for numeric)
✅ ⭐ [News API] 8 range facet fields now available:
- Date fields: published_at - analyze article distribution over time
- Sentiment scores: sentiment.overall.score, sentiment.title.score, sentiment.body.score
- Content metrics: read_time, media.images.count, media.videos.count
- Source quality: source.rank.opr

1.0.21

✅ ⭐ [News API] Add Faceting support - get aggregated counts of articles grouped by specific fields. Enables building filtered navigation, analytics dashboards, and understanding result distribution.
✅ ⭐ [News API] 24 facet fields now available including:
- Source fields: source.id, source.country.id, source.bias, source.rank.opr
- Classification: category.id, topic.id, industry.id
- Language & Author: language.id, author.id
- Sentiment: sentiment.overall.polarity, sentiment.title.polarity, sentiment.body.polarity
- Article attributes: is_duplicate, is_free, is_important
- Media content: media.images.count, media.videos.count
- Reading time: read_time
- Temporal analysis: published.year, published.month, published.day_of_week, published.hour

1.0.20

✅ ⭐ [News API] Add Highlighting support - get text snippets with matching search terms highlighted. Perfect for building search result pages with visual context.
✅ ⭐ [News API] Highlighting with Dictionary Integration - automatically expands search terms using synonyms and morphology for smarter highlighting
✅ ⭐ [News API] Highlighting parameters:
- hl - Enable/disable highlighting
- hl.fl - Fields to highlight (title, description, body)
- hl.fragsize - Snippet size (50-500 characters)
- hl.snippets - Number of snippets per field (1-10)
- hl.tag.pre / hl.tag.post - Custom highlight tags (default: <em> / </em>)

1.0.19

✅ ⭐ [News API] Add new parameter fl (field list) - select specific fields to return in API responses, similar to Apache Solr's fl parameter. Supports nested field selection using dot notation (e.g., fl=id,title,source.name,sentiment.overall.score).

1.0.18

✅ ⭐ [News API] Add new endpoint /v1/suggest/entities - autocomplete search for entities by name prefix. Returns matching entities with their details, types, and links to Wikipedia/Wikidata.

1.0.17

✅ ⭐ [News API] Add new endpoint /v1/balance - check your API key balance and remaining credits. Returns api_key, points, and plan information.
✅ 🔒 [News API] Add rate limiting to /v1/balance endpoint - limited to 30 requests per minute per API key to prevent abuse.

1.0.16

✅ ⭐ [News API] Add new entity type filters: disaster.name, ignore.disaster.name, has_disaster - filter articles by disaster entities.
✅ ⭐ [News API] Add new entity type filters: disease.name, ignore.disease.name, has_disease - filter articles by disease entities.
✅ ⭐ [News API] Add new entity type filters: event.name, ignore.event.name, has_event - filter articles by event entities.

1.0.15

✅ ⭐ [News API] Add new key "body_html" to the article resource. The value is pure HTML article. Available since December 30, 2025.

1.0.14

✅ ⭐ [News API] Add new key "is_breaking" to the article resource. The value is true if the article is breaking news, otherwise false.
✅ ⭐ [News API] Add new key "read_time" to the article resource. The value is the estimated time to read the article in minutes.

1.0.13

✅ ⭐ [News API] Add new key "source.bias" to the article resource. The value is the bias of the source, which can be one of the following: left, right, center.
✅ ⭐ [News API] Add new section in the documentation: List of Entities. This section provides a list of entities that can be used to filter news articles.

1.0.12

✅ ⭐ [News API] Updated categories. See the full list of categories in the documentation.

1.0.11

✅ ⭐ [News API] Add new topics with the latest news from the commodities market.

1.0.10

✅ ⭐ [News API] Fixed rate limiter for all plans. Now the rate limiter is working correctly for all plans.

1.0.9

✅ ⭐ [News API] New key "is_paywall" to the article resource. The value is true if the article is behind a paywall, otherwise false.
✅ ⭐ [News API] Filter by paywall articles. Example: https://api.apitube.io/v1/news/everything?is_paywall=true. More examples in the documentation.
✅ ⭐ [News API] Filter by duplicate articles. Example: https://api.apitube.io/v1/news/everything?is_duplicate=true. More examples in the documentation.
✅ ⭐ [News API] New key "favicon" in the source resource. The value is the URL of the source's favicon.

1.0.8

✅ ⭐ [News API] Get news by topics: crypto news, movies news, video games news

1.0.7

✅ ⭐ [News API] New articles export formats: XML, XML, XLSX, CSV, CSV.

1.0.6

✅ ⭐ [News API] Add 'story_id' as property to the article resource. Story ID is a unique identifier for the story.

1.0.5

✅ ⭐ [News API] Add 'links' and 'videos' as property to the article resource. Links are a list of links to related articles.

1.0.4

✅ ⭐ [News API] Add 'opinion' resource type. Opinion articles are articles that are written by a person that expresses an opinion or point of view. Opinion articles are not news articles.

1.0.3

✅ ⭐ [News API] Add filter 'search' to search find articles by title or content match. Example: https://api.apitube.io/v1/news/everything?search=bitcoin.
✅ ⭐ [News API] Limit of articles per page for a paid user reached 1000 items per page.

1.0.2

✅ ⭐ [News API] Add new integrations: Dart, Elixir, Haskell, Lua, Scala, Rust.

1.0.1

✅ ⭐ [News API] Add new categories.
✅ ⭐ [News API] Articles body text(with tags) now trim data.

Suggest Endpoints

Examples

Getting started

Changelog

1.0.31

1.0.30

1.0.29

1.0.28

1.0.27

1.0.26

1.0.25

1.0.24

1.0.23

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

Changelog ​

1.0.31 ​

1.0.30 ​

1.0.29 ​

1.0.28 ​

1.0.27 ​

1.0.26 ​

1.0.25 ​

1.0.24 ​

1.0.23 ​

1.0.22 ​

1.0.21 ​

1.0.20 ​

1.0.19 ​

1.0.18 ​

1.0.17 ​

1.0.16 ​

1.0.15 ​

1.0.14 ​

1.0.13 ​

1.0.12 ​

1.0.11 ​

1.0.10 ​

1.0.9 ​

1.0.8 ​

1.0.7 ​

1.0.6 ​

1.0.5 ​

1.0.4 ​

1.0.3 ​

1.0.2 ​

1.0.1 ​

Changelog

1.0.31

1.0.30

1.0.29

1.0.28

1.0.27

1.0.26

1.0.25

1.0.24

1.0.23

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1