APITube Documentation

Appearance

Sign inGet started

Person Query Examples ​

Search for news about a specific person ​

This query retrieves news articles about Satoshi Nakamoto.

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

Search for news about multiple people ​

This query retrieves news articles about Satoshi Nakamoto and Vitalik Buterin.

python
params = {
    "person.name": "Satoshi,Vitalik",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Satoshi,Vitalik&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": "cnn.com,foxnews.com,bbc.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=cnn.com,foxnews.com,bbc.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 Tim Cook and Apple.

python
params = {
    "person.name": "Tim Cook",
    "organization.name": "Apple",
    "published_at.start": "2023-01-01",
    "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=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 ​

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

python
params = {
    "person.name": "Elon Musk",
    "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"
}
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 ​

This query finds research publications mentioning Stephen Hawking.

python
params = {
    "person.name": "Stephen Hawking",
    "category.id": "15",
    "published_at.start": "2018-01-01",
    "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=Stephen%20Hawking&category.id=15&published_at.start=2018-01-01&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 during an election period.

python
params = {
    "person.name": "Joe Biden",
    "category.id": "3",
    "published_at.start": "2020-09-01",
    "published_at.end": "2020-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?person.name=Joe%20Biden&category.id=3&published_at.start=2020-09-01&published_at.end=2020-11-30&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": "Mark Zuckerberg,Sundar Pichai,Satya Nadella",
    "language.code": "en,zh,de",
    "source.country.code": "us,gb,de,in",
    "media.images.count": "1",
    "published_at.start": "2023-01-01",
    "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=Mark%20Zuckerberg,Sundar%20Pichai,Satya%20Nadella&language.code=en,zh,de&source.country.code=us,gb,de,in&media.images.count=1&published_at.start=2023-01-01&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": "Bill Gates",
    "location.name": "Africa,India,China,United States",
    "title": "philanthropy,foundation,donation,initiative",
    "published_at.start": "2023-01-01",
    "sort.by": "location.name,sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Bill%20Gates&location.name=Africa,India,China,United%20States&title=philanthropy,foundation,donation,initiative&published_at.start=2023-01-01&sort.by=location.name,sentiment.overall.score&api_key=YOUR_API_KEY"