APITube Documentation

Appearance

Sign inGet started

Person Query Examples ​

Search for news about a specific person ​

This query retrieves news articles about Elon Musk.

python
params = {
    "person.name": "Elon Musk",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&api_key=YOUR_API_KEY"

Search for news about multiple people ​

This query retrieves news articles about Elon Musk and Donald Trump.

python
params = {
    "person.name": "Elon Musk,Donald Trump",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk,Donald%20Trump&api_key=YOUR_API_KEY"

Person sentiment analysis across different news sources ​

This query analyzes sentiment differences in coverage of Elon Musk across different news providers.

python
params = {
    "person.name": "Elon Musk",
    "source.domain": "theguardian.com,foxnews.com,nytimes.com",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&source.domain=theguardian.com,foxnews.com,nytimes.com&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Cross-reference person with organizations ​

This query retrieves news articles that mention both Elon Musk and Tesla.

python
params = {
    "person.name": "Elon Musk",
    "organization.name": "Tesla",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&organization.name=Tesla&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"

Public figure controversy timeline ​

This query creates a chronological timeline of negative news about Elon Musk.

python
params = {
    "person.name": "Elon Musk",
    "sentiment.overall.polarity": "negative",
    "sort.by": "published_at",
    "sort.order": "asc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&sentiment.overall.polarity=negative&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Person mention in news ​

This query finds news mentioning Donald Trump.

python
params = {
    "person.name": "Donald Trump",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Donald%20Trump&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"

Tracking a politician's media coverage ​

This query tracks media coverage of a politician.

python
params = {
    "person.name": "Donald Trump",
    "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?person.name=Donald%20Trump&category.id=medtop:11000000&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Multiple person comparative media analysis ​

This query compares media coverage of multiple tech leaders across different regions and languages, with visual content requirements.

python
params = {
    "person.name": "Elon Musk,Donald Trump",
    "language.code": "en,de",
    "source.country.code": "us,gb,de",
    "sort.by": "person.name,source.country.code",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk,Donald%20Trump&language.code=en,de&source.country.code=us,gb,de&sort.by=person.name,source.country.code&api_key=YOUR_API_KEY"

Person and location context analysis ​

This query analyzes mentions of a specific person in relation to various geographic locations to map their global activities and perception.

python
params = {
    "person.name": "Donald Trump",
    "title": "economy,trade,tariff",
    "sort.by": "sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Donald%20Trump&title=economy,trade,tariff&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"