Parameters by endpoint
Title
Get articles with a specific title.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
title | The title of articles. Supports up to 5 languages simultaneously, separated by commas. | string | No | Bitcoin |
ignore.title | The title of articles to ignore. Supports up to 5 languages simultaneously, separated by commas. | string | No | Ethereum |
title_starts_with | The title of articles that start with a specific string | string | No | Bitcoin |
title_ends_with | The title of articles that end with a specific string. | string | No | Bitcoin |
title_pattern | The title of articles that match a specific pattern. Example: ^[A-Za-z]+$ | string | No | Bitcoin |
Workflow examples
Request for Positive Sentiment News:
This request retrieves news articles with "technology" in their titles.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=technology&api_key=YOUR_API_KEY"Request for Articles with Multiple Title Keywords:
This request retrieves news articles with either "AI" or "innovation" in their titles.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=AI,innovation&api_key=YOUR_API_KEY"Request for Articles with Titles Excluding Certain Words:
This request retrieves news articles that do not have "celebrity" in their titles.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?ignore.title=celebrity&api_key=YOUR_API_KEY"Complex Title Pattern with Regex:
This request retrieves news articles that match a specific regex pattern in their titles.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title_pattern=^Breaking%20News:%20[A-Za-z]+&api_key=YOUR_API_KEY"Combined Title Filters for Specific News:
This request combines title filters to find articles about AI but not about job losses.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=AI&ignore.title=layoffs,job%20losses&title_starts_with=Breaking&api_key=YOUR_API_KEY"Title Analysis for Market Trends:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title_pattern=(bull|bear)%20market&category.id=2&published_at.start=2023-01-01&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Targeted Industry News Headlines:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=semiconductor&title_ends_with=shortage&industry.id=246771&published_at.start=2023-01-01&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Languages
APITube has 60+ more languages available for the News API. You can specify the language of the articles you want to retrieve.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
language.code | The language code of the articles you want to retrieve. Supports up to 3 languages simultaneously, separated by commas. | string | No | en |
ignore.language.code | The language code of the articles you want to exclude. Supports up to 3 languages simultaneously, separated by commas. | string | No | fr |
Workflow examples
Request to get news articles excluding those from France and in the French language:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?ignore.source.country.code=fr&ignore.language.code=fr&api_key=YOUR_API_KEY"Request to get news articles in the English and French languages:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=en,fr&api_key=YOUR_API_KEY"Multi-language Analysis with Source Filtering:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=en,ja,de&source.rank.opr.min=0.7&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Language-Specific Business News:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=zh,ko&category.id=2&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Multilingual Brand Sentiment Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=en,fr,de,ja&brand.name=Netflix&sentiment.overall.polarity=positive&published_at.start=2023-01-01&sort.by=published_at&api_key=YOUR_API_KEY"Regional Language News Comparison:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=ar,he&category.id=3&published_at.start=2023-01-01&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Categories
Get articles with a specific category.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
category.id | The category ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | 314 |
ignore.category.id | The category ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | 315 |
List of supported categories taxonomy
| Taxonomy | Description |
|---|---|
iptc | IPTC |
iab | IAB |
apitube | APITube |
Workflow examples
Request to get news articles from a specific category (e.g., "Business"):
This request retrieves news articles that fall under the "business" category.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=2&api_key=YOUR_API_KEY"Request for Articles in Multiple Categories:
This request retrieves news articles that are in either the "technology" category.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=4&api_key=YOUR_API_KEY"Request for Articles in a Category and Filtered by Language:
This request retrieves news articles in the "politics" category that are in French.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=3&language=fr&api_key=YOUR_API_KEY"Cross-Taxonomy Category Filtering:
This request retrieves articles that match specific categories from different taxonomies.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=4&category.taxonomy=iptc,iab&sentiment.overall.polarity=positive&api_key=YOUR_API_KEY"Category Time-Series Analysis:
This request enables time-series analysis of articles in the "finance" category over a specific time period.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=6&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&per_page=100&api_key=YOUR_API_KEY"Category-Based Media Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=7&media.images.count=3&source.rank.opr.min=0.7&published_at.start=2023-01-01&sort.by=media.images.count&sort.order=desc&api_key=YOUR_API_KEY"Cross-Category Sentiment Comparison:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=2,3,4&sentiment.overall.polarity=positive&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=category.id&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Topics
Get articles with a specific topic.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
topic.id | The topic ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | integer | No | 1 |
ignore.topic.id | The topic ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | integer | No | 2 |
Workflow examples
Request to get news articles from a specific topic (e.g., "crypto_news"):
This request retrieves news articles that fall under the "crypto news" topic.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=crypto_news&api_key=YOUR_API_KEY"Multi-Topic Sentiment Analysis:
This request analyzes sentiment across multiple related topics.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=climate_change,renewable_energy,carbon_emissions&sentiment.overall.polarity=positive&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Comparative Topic Analysis with Language Filtering:
This request compares coverage of different topics across specific languages.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=artificial_intelligence,machine_learning&language.code=en,de,jp&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Topic and Entity Intersection Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=cryptocurrency&entity.id=326,327&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Topic-Based Expert Opinion Tracking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=quantum_computing&author.name=Michio%20Kaku,Brian%20Greene&published_at.start=2020-01-01&sort.by=published_at&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Industries
Get articles with a specific industry.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
industry.id | The industry ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | 246771 |
ignore.industry.id | The industry ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | 246772 |
Industry Sector Performance Tracking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?industry.id=246771,246772&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Cross-Industry Innovation Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?industry.id=246771,246772&title=innovation&sentiment.overall.polarity=positive&published_at.start=2023-01-01&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Entities
Get articles with a specific entity.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
entity.id | The entity ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | 314 |
ignore.entity.id | The entity ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | 315 |
Workflow examples
Request to get news articles about a specific entity (e.g., "Bitcoin"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&api_key=YOUR_API_KEY"Request to get news articles about multiple entities (e.g., "Bitcoin" and "Ethereum"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314,315&api_key=YOUR_API_KEY"Request to get news articles about an entity while ignoring another:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&ignore.entity.id=315&api_key=YOUR_API_KEY"Entity Correlation Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314,315,316&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Entity Mention Tracking Over Time:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&published_at.start=2022-01-01&published_at.end=2023-12-31&per_page=100&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Entity Co-occurrence Network Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&entity.type=ORGANIZATION&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&api_key=YOUR_API_KEY"Entity Impact on Market Sentiment:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314,315&category.id=2&sentiment.overall.score.min=0.7&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Persons
Get articles with a specific person.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
person.name | The person name of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | Satoshi |
ignore.person.name | The person name of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | Vitalik |
Workflow examples
Request to get news articles about a specific person (e.g., "Satoshi"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Satoshi&api_key=YOUR_API_KEY"Request to get news articles about multiple people (e.g., "Satoshi" and "Vitalik"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Satoshi,Vitalik&api_key=YOUR_API_KEY"Person Sentiment Analysis Across Sources:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&source.domain=cnn.com,foxnews.com,bbc.com&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Cross-reference Person with Organizations:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Tim%20Cook&organization.name=Apple&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Public Figure Controversy Timeline:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&sentiment.overall.polarity=negative&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Person Mention in Research Publications:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Stephen%20Hawking&category.id=15&published_at.start=2018-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Locations
Get articles from a specific location.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
location.name | The location name of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | Tokyo |
ignore.location.name | The location name of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | New York |
Workflow examples
Request to get news articles from a specific location (e.g., "Tokyo"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Tokyo&api_key=YOUR_API_KEY"Request to get news articles from multiple locations (e.g., "Tokyo" and "New York"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Tokyo,New York&api_key=YOUR_API_KEY"Request to get news articles from a specific location and in a specific language (e.g., "Tokyo" and "Japanese") and ignore articles from "New York":
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Tokyo&language=ja&ignore.location.name=New York&api_key=YOUR_API_KEY"Geopolitical Event Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=France,Italy&category.id=3&published_at.start=2022-02-01&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Multi-Location Business Impact Study:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Silicon%20Valley,Shanghai,Bangalore&category.id=2,4&organization.name=Apple,Google,Microsoft&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Natural Disaster Coverage Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Florida,Louisiana&title=hurricane&published_at.start=2022-06-01&published_at.end=2022-11-30&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Tourism Sentiment Analysis by Location:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Bali,Phuket,Maldives&category.id=10&sentiment.overall.polarity=positive&published_at.start=2023-01-01&sort.by=published_at&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Organizations
Get articles with a specific organization.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
organization.name | The organization name of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | Google |
ignore.organization.name | The organization name of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | Apple |
Workflow examples
Request to get news articles about a specific organization (e.g., "Google"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Google&api_key=YOUR_API_KEY"Request to get news articles about multiple organizations (e.g., "Google" and "Apple"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Google,Apple&api_key=YOUR_API_KEY"Request to get news articles about an organization while ignoring another (e.g., "Google" and excluding "Apple"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Google&ignore.organization.name=Apple&api_key=YOUR_API_KEY"Competitive Intelligence Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Tesla,Ford,Toyota&category.id=4,6&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Organization Sentiment Tracking During Financial Events:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=JP%20Morgan&published_at.start=2023-04-01&published_at.end=2023-04-30&sort.by=published_at&sort.order=asc&category.id=2&api_key=YOUR_API_KEY"Corporate Social Responsibility Coverage:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Microsoft,Google,Amazon&title=sustainability,ESG,green&published_at.start=2023-01-01&sentiment.overall.polarity=positive&api_key=YOUR_API_KEY"Executive Leadership Transition Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Disney&title=CEO&published_at.start=2022-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Brands
Get articles with a specific brand.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
brand.name | The brand name of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | Nike |
ignore.brand.name | The brand name of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No | Adidas |
Workflow examples
Request to get news articles about a specific brand (e.g., "Nike"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike&api_key=YOUR_API_KEY"Request to get news articles about multiple brands (e.g., "Nike" and "Adidas"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike,Adidas&api_key=YOUR_API_KEY"Request to get news articles about a brand while ignoring another (e.g., "Nike" and excluding "Adidas"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike&ignore.brand.name=Adidas&api_key=YOUR_API_KEY"Brand Reputation Analysis Across Markets:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Samsung&source.country.code=us,kr,in&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Product Launch Media Coverage Tracking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Apple&title_pattern=iPhone%2015&published_at.start=2023-09-01&published_at.end=2023-10-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Brand Sponsorship Impact Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Rolex,Omega,Tag%20Heuer&title=sponsorship,tournament,championship&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Brand Crisis Management Tracking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Boeing&title=737%20MAX&sentiment.overall.polarity=negative&published_at.start=2019-03-01&published_at.end=2020-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Authors
Get articles with a specific author.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
author.id | The author ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No |
ignore.author.id | The author ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No |
author.name | The author name of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No |
ignore.author.name | The author name of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | string | No |
Workflow examples
Request to get news articles by a specific author (e.g., "John Doe"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=John Doe&api_key=YOUR_API_KEY"Request to get news articles by multiple authors (e.g., "John Doe" and "Jane Doe"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=John Doe,Jane Doe&api_key=YOUR_API_KEY"Request to get news articles by a specific author and in a specific language (e.g., "John Doe" and "English"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=John Doe&language=en&api_key=YOUR_API_KEY"Author Expertise Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=Ezra%20Klein&category.id=3,6&sort.by=published_at&sort.order=desc&per_page=50&api_key=YOUR_API_KEY"Cross-Source Author Contribution Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=Kara%20Swisher&source.domain=nytimes.com,wsj.com,vox.com&published_at.start=2020-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Author Sentiment Bias Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=George%20Stephanopoulos,Sean%20Hannity&organization.name=Biden%20Administration&published_at.start=2023-01-01&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"Author Topic Evolution Tracking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?author.name=Yuval%20Noah%20Harari&published_at.start=2018-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&per_page=100&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Sentiments
Get articles with a specific sentiment score.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
By sentiment score
You can use the sentiment.overall.score parameter to specify the overall sentiment score of the articles you want to retrieve.
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
sentiment.overall.score | The overall sentiment score of the articles. | float | No | 0.2 |
sentiment.overall.score.min | The overall sentiment score of the articles. | float | No | 0.5 |
sentiment.overall.score.max | The overall sentiment score of the articles. | float | No | 1.0 |
sentiment.overall.polarity | The overall sentiment polarity of the articles. | string | No | positive |
By sentiment polarity
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
positive | Retrieve articles with positive sentiment. | string | No |
negative | Retrieve articles with negative sentiment. | string | No |
neutral | Retrieve articles with neutral sentiment. | string | No |
Workflow examples
Request for Positive Sentiment News:
This request retrieves news articles that have been classified with a positive sentiment.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.polarity=positive&api_key=YOUR_API_KEY"Request for Positive Sentiment News from a Specific Country:
This request fetches news articles with positive sentiment specifically from Japan
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.polarity=positive&source.country.code=jp&api_key=YOUR_API_KEY"Request for Positive Sentiment News in the Last 24 Hours:
This request retrieves news articles with positive sentiment published in the last 24 hours.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.polarity=positive&published_at.start=2024-12-02&published_at.end=2024-12-03&api_key=YOUR_API_KEY"Request for Articles with Positive Sentiment and a Specific Title:
This request retrieves news articles with positive sentiment that have "technology" in their titles.
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.polarity=positive&title=technology&api_key=YOUR_API_KEY"Multi-dimensional Sentiment Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.score.min=0.7&category.id=2,4&organization.name=Tesla,SpaceX&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Comparative Sentiment Analysis Across Markets:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sentiment.overall.polarity=negative&source.country.code=us,uk,de&category.id=6&published_at.start=2023-01-01&published_at.end=2023-12-31&api_key=YOUR_API_KEY"Sentiment Divergence Analysis by Source Type:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=climate_change&sentiment.overall.score.min=0.6&source.domain=scientific.journals,mainstream.news&published_at.start=2023-01-01&sort.by=source.domain&api_key=YOUR_API_KEY"Product Review Sentiment Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?title=review&brand.name=Samsung%20Galaxy%20S23&sentiment.overall.score.min=-1.0&sentiment.overall.score.max=1.0&published_at.start=2023-01-01&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Media
Get articles with a specific media type and size.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
media.images.count | The number of images in the articles. | integer | No | 2 |
media.videos.count | The number of videos in the articles. | integer | No | 1 |
media.images.width.min | The minimum width of the images. | integer | No | 200 |
media.images.width.max | The maximum width of the images. | integer | No | 800 |
media.images.height.min | The minimum height of the images. | integer | No | 200 |
media.images.height.max | The maximum height of the images. | integer | No | 800 |
Workflow examples
Request to get news articles with a specific number of images and videos:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&media.videos.count=1&api_key=YOUR_API_KEY"Request to get news articles with images of a specific size:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.width.min=200&media.images.width.max=800&media.images.height.min=200&media.images.height.max=800&api_key=YOUR_API_KEY"Rich Media Content Curation:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=3&media.videos.count=1&category.id=4&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"High-Quality Visual News Aggregation:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.width.min=1200&media.images.height.min=800&media.images.count=2&sentiment.overall.polarity=positive&category.id=4,7&source.rank.opr.min=0.7&api_key=YOUR_API_KEY"Video Content Analysis for Educational Topics:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.videos.count=2&category.id=15&title=education,learning,tutorial&published_at.start=2023-01-01&sort.by=media.videos.count&sort.order=desc&api_key=YOUR_API_KEY"Interactive Media Content Curation:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=3&media.videos.count=1&media.interactive.count=1&category.id=4,7&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Source
Get articles with a specific source or sources.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
source.id | The source ID of the articles. Supports up to 3 languages simultaneously, separated by commas. | int | No | 314 |
ignore.source.id | The source ID of the articles to ignore. Supports up to 3 languages simultaneously, separated by commas. | int | No | 315 |
source.domain | The source domain of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | cnn.com |
ignore.source.domain | Ignore the source domain of the articles. Supports up to 3 languages simultaneously, separated by commas. | string | No | techcrunch.com |
source.country.code | The country code of the articles you want to retrieve. Supports up to 3 languages simultaneously, separated by commas. | string | No | us |
ignore.source.country.code | The country code of the articles you want to exclude. Supports up to 3 languages simultaneously, separated by commas. | string | No | fr |
source.rank.opr.min | The minimum Open Page Rank source rank. Value from 0 to 7. | string | No | 0.5 |
source.rank.opr.max | The maximum Open Page Rank source rank. Value from 0 to 7. | string | No | 0.9 |
Workflow examples
Request to get news articles from a specific source (e.g., "cnn.com"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?source.domain=cnn.com&api_key=YOUR_API_KEY"Request to get news articles from multiple sources (e.g., "cnn.com" and "bbc.com"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?source.domain=cnn.com,bbc.com&api_key=YOUR_API_KEY"Request to get news articles from a specific source and in a specific language (e.g., "cnn.com" and "English"):
shell
curl -X GET "https://api.apitube.io/v1/news/everything?source.domain=cnn.com&language=en&api_key=YOUR_API_KEY"Request to get news articles with rank between 0.5 and 0.9:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?source.rank.opr.min=0.5&source.rank.opr.max=0.9&api_key=YOUR_API_KEY"Cross-Regional Media Bias Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=climate_change&source.country.code=us,ru,cn&sort.by=sentiment.overall.score&published_at.start=2023-01-01&published_at.end=2023-12-31&api_key=YOUR_API_KEY"High-Credibility Financial News Aggregation:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=2&source.rank.opr.min=0.8&source.domain=wsj.com,ft.com,bloomberg.com,reuters.com&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Datetime
With the News API, you can specify the date range of the articles you want to retrieve. You can use the published_at.start and published_at.end parameters to specify the date range. The date range is inclusive, meaning that the articles published on the start date and the end date are included in the result.
All datetime math functions using AQL format.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
published_at.start | The start date of the date range. | string | No | 2022-03-14 |
published_at.end | The end date of the date range. | string | No | 2025-12-16 |
published_at | The date of the articles you want to retrieve. | string | No | 2025-09-26 |
Date Formats
You can use the following date formats to specify the date range:
| Example | Description |
|---|---|
2025-01-02T15:04:05Z | The date and time in the YYYY-MM-DDTHH:MM:SSZ format. |
2025-01-02 | The date in the YYYY-MM-DD format. |
02-01-2006 | The date in the DD-MM-YYYY format. |
2006-01-02T15:04:05-07:00 | The date and time in the YYYY-MM-DDTHH:MM:SSZ format. |
2006-01-02T15:04:05.000Z | The date and time in the YYYY-MM-DDTHH:MM:SS.MMMZ format. |
Mon, 02 Jan 2006 15:04:05 MST | The date and time in the D, DD MMM YYYY HH:MM:SS Z format. |
2006-01-02T15:04:05-07:00 | The date and time in the YYYY-MM-DDTHH:MM:SSZ format. |
2006-01-02T15:04:05Z07:00 | The date and time in the YYYY-MM-DDTHH:MM:SSZ07:00 format. RFC3339 without the T separator. |
Mon, 02 Jan 2006 15:04:05 -0700 | The date and time in the D, DD MMM YYYY HH:MM:SS Z format. For example, Mon, 02 Jan 2006 15:04:05 -0700. |
Workflow examples
Request to get news articles within a specific date range:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?published_at.start=2022-01-01&published_at.end=2022-01-31&api_key=YOUR_API_KEY"Request to get news using a relative time range:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?published_at.start=2025-01-02&published_at.end=2006-01-04&api_key=YOUR_API_KEY"Complex Date-Range Analysis with Precise Timestamps:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Federal%20Reserve&published_at.start=2023-03-21T14:00:00Z&published_at.end=2023-03-22T14:00:00Z&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Sorting
With the News API, you can sort the articles by the following parameters:
sort.bysort.order
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters for sorting articles (sort.by)
By default, the articles are sorted by the published date in descending order. You can use the sort.by parameter to specify the sorting criteria.
| Parameter | Description | Type | Required |
|---|---|---|---|
published_at | Sort by the published date. | string | No |
relevance | Sort by relevance. | string | No |
sentiment.overall.score | Sort by the overall sentiment magnitude. | string | No |
source.rank.opr | Sort by the Open Page Rank source rank. | string | No |
media.images.count | Sort by the number of images. | string | No |
media.videos.count | Sort by the number of videos. | string | No |
Parameters for sorting order (sort.order)
By default, the articles are sorted in descending order. You can use the asc and desc parameters to specify the sorting order.
| Parameter | Description | Type | Required |
|---|---|---|---|
asc | Sort in ascending order. | string | No |
desc | Sort in descending order. | string | No |
Workflow examples
Request to get news articles sorted by the published date in ascending order:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"Request to get news articles sorted by the overall sentiment magnitude in descending order:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"Multi-dimensional Content Ranking:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=4&source.rank.opr.min=0.7&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Media-Rich Content Prioritization:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&media.videos.count=1&sort.by=media.images.count&sort.order=desc&category.id=4,7&published_at.start=2023-01-01&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Pagination
With the News API, you can paginate the articles you want to retrieve.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Pagination with limit and offset
You can use the per_page and page parameters to specify the number of articles you want to retrieve and the starting point of the articles.
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
per_page | The number of articles you want to retrieve. | integer | No |
page | The starting point of the articles. | integer | No |
Workflow examples
Request to get news articles with pagination:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?per_page=10&page=1&api_key=YOUR_API_KEY"Efficient Large Dataset Retrieval:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=4&published_at.start=2023-01-01&published_at.end=2023-12-31&per_page=100&page=1&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"Paginated Multi-criteria Search:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Amazon&sentiment.overall.polarity=positive&per_page=25&page=3&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Other filters
Other powerful filters are available to help you find the articles you need.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
0 is for false and 1 is for true.
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
is_duplicate | Filter articles that are duplicates. | integer | No | 0 |
is_paywall | Filter articles that are behind a paywall | integer | No | 0 |
High-Quality Content Filtering:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?is_duplicate=0&is_paywall=0&source.rank.opr.min=0.7&category.id=2&published_at.start=2023-01-01&api_key=YOUR_API_KEY"Premium Content Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?is_paywall=1&source.domain=wsj.com,ft.com,economist.com&category.id=2&published_at.start=2023-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"More examples can be found in the News API Examples page.
Export articles
With the News API, you can export the articles in formats such as JSON, XML, XLSX, CSV and TSV.
Endpoints
/v1/news/everything
/v1/news/top-headlines
/v1/news/story
/v1/news/article
/v1/news/category
/v1/news/topic
/v1/news/industry
/v1/news/entity
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
export | The format in which you want to export. | string | No | json |
Formats
| Format | Description |
|---|---|
json | JSON |
xml | XML |
xlsx | XLSX |
csv | CSV |
tsv | TSV |
Data Export for Financial Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=2&published_at.start=2023-01-01&published_at.end=2023-12-31&export=xlsx&api_key=YOUR_API_KEY" -o financial_news_2023.xlsxCSV Export for Sentiment Analysis:
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Amazon,Microsoft,Google&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=sentiment.overall.score&sort.order=desc&export=csv&api_key=YOUR_API_KEY" -o tech_sentiment_2023.csvMore examples can be found in the News API Examples page.
Get single article
Get a single article by its ID.
Endpoints
/v1/news/article
Parameters
| Parameter | Description | Type | Required | Example |
|---|---|---|---|---|
id | The ID of the article you want to retrieve. Supports up to 3 languages simultaneously, separated by commas. | string | Yes | 314 |
Workflow examples
Request to get a single article by its ID:
shell
curl -X GET "https://api.apitube.io/v1/news/article?id=314&api_key=YOUR_API_KEY"Detailed Article Export in Multiple Formats:
shell
curl -X GET "https://api.apitube.io/v1/news/article?id=314&export=json&api_key=YOUR_API_KEY" -o article_314.json
curl -X GET "https://api.apitube.io/v1/news/article?id=314&export=xml&api_key=YOUR_API_KEY" -o article_314.xmlMore examples can be found in the News API Examples page.