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 London and Paris.

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

Filter by location and language ​

This query retrieves news articles about London in English, excluding articles about Ontario.

python
params = {
    "location.name": "London",
    "language.code": "en",
    "ignore.location.name": "Ontario",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=London&language.code=en&ignore.location.name=Ontario&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": "medtop:11000000",
    "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=medtop:11000000&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 London, Berlin, and Paris.

python
params = {
    "location.name": "London,Berlin,Paris",
    "category.id": "medtop:04000000",
    "organization.name": "Google,Microsoft,Amazon",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=London,Berlin,Paris&category.id=medtop:04000000&organization.name=Google,Microsoft,Amazon&api_key=YOUR_API_KEY"

Natural disaster coverage analysis ​

This query tracks earthquake coverage in Japan and Israel.

python
params = {
    "location.name": "Japan,Israel",
    "title": "earthquake",
    "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=Japan,Israel&title=earthquake&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": "London,Paris,Berlin",
    "sentiment.overall.polarity": "positive",
    "sort.by": "published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=London,Paris,Berlin&sentiment.overall.polarity=positive&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.

python
params = {
    "location.name": "India,Brazil",
    "title": "infrastructure,development,investment",
    "category.id": "medtop:04000000",
    "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&title=infrastructure,development,investment&category.id=medtop:04000000&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,Israel",
    "category.id": "medtop:11000000",
    "language.code": "en",
    "sort.by": "sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?location.name=Ukraine,Israel&category.id=medtop:11000000&language.code=en&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"