APITube Documentation

Appearance

Sign inGet started

Searching by Location ​

Search articles in a specific location ​

This query retrieves news articles about Paris.

python
params = {
    "location.name": "Paris",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Paris&api_key=YOUR_API_KEY"

Search articles in multiple locations ​

This query retrieves news articles about Tokyo and New York.

python
params = {
    "location.name": "Tokyo,New York",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Tokyo,New York&api_key=YOUR_API_KEY"

Filter by location and language ​

This query retrieves news articles about Tokyo in Japanese, excluding articles about New York.

python
params = {
    "location.name": "Tokyo",
    "language.code": "ja",
    "ignore.location.name": "New York",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Tokyo&language.code=ja&ignore.location.name=New York&api_key=YOUR_API_KEY"

Geopolitical event analysis ​

This query analyzes coverage of geopolitical events in France and Italy.

python
params = {
    "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"
}
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"

Business impact analysis across multiple locations ​

This query analyzes business news about major tech companies across Silicon Valley, Shanghai, and Bangalore.

python
params = {
    "location.name": "Silicon Valley,Shanghai,Bangalore",
    "category.id": "2,4",
    "organization.name": "Apple,Google,Microsoft",
    "published_at.start": "2023-01-01",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Silicon Valley,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 ​

This query tracks hurricane coverage in Florida and Louisiana during hurricane season.

python
params = {
    "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"
}
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 ​

This query analyzes positive sentiment in tourism news about popular destinations.

python
params = {
    "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"
}
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"

Global infrastructure development tracking ​

This query tracks infrastructure developments across emerging markets with cross-referenced industry categorization and high-quality source filtering.

python
params = {
    "location.name": "India,Brazil,Indonesia,Nigeria,Vietnam",
    "title": "infrastructure,development,construction,investment",
    "category.id": "2,12",
    "industry.id": "246771,246775",
    "source.rank.opr.min": "0.7",
    "published_at.start": "2023-01-01",
    "sort.by": "location.name,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=India,Brazil,Indonesia,Nigeria,Vietnam&title=infrastructure,development,construction,investment&category.id=2,12&industry.id=246771,246775&source.rank.opr.min=0.7&published_at.start=2023-01-01&sort.by=location.name,published_at&api_key=YOUR_API_KEY"

Regional conflict media coverage analysis ​

This query analyzes how different news sources cover regional conflicts with sentiment analysis and language-specific filtering.

python
params = {
    "location.name": "Ukraine,Russia,Israel,Palestine,Gaza",
    "category.id": "3",
    "source.country.code": "us,gb,fr,de,ru,cn",
    "language.code": "en,ru,fr,de,zh",
    "published_at.start": "2023-01-01",
    "sort.by": "source.country.code,sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Ukraine,Russia,Israel,Palestine,Gaza&category.id=3&source.country.code=us,gb,fr,de,ru,cn&language.code=en,ru,fr,de,zh&published_at.start=2023-01-01&sort.by=source.country.code,sentiment.overall.score&api_key=YOUR_API_KEY"