APITube Documentation

Appearance

Sign inGet started

Topic Query Examples ​

Search for news on a specific topic ​

This query retrieves news articles about cryptocurrency.

python
params = {
    "topic.id": "crypto_news",
    "api_key": "YOUR_API_KEY"
}
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 query analyzes positive sentiment across climate-related topics.

python
params = {
    "topic.id": "climate_change,renewable_energy,carbon_emissions",
    "sentiment.overall.polarity": "positive",
    "published_at.start": "2023-01-01",
    "api_key": "YOUR_API_KEY"
}
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 query compares AI topics across different languages.

python
params = {
    "topic.id": "artificial_intelligence,machine_learning",
    "language.code": "en,de,jp",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
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 ​

This query analyzes cryptocurrency news in relation to specific entities.

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

This query finds opinions from specific experts on quantum computing.

python
params = {
    "topic.id": "quantum_computing",
    "author.name": "Michio Kaku,Brian Greene",
    "published_at.start": "2020-01-01",
    "sort.by": "published_at",
    "api_key": "YOUR_API_KEY"
}
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"

This query analyzes how a topic has trended over time.

python
params = {
    "topic.id": "metaverse",
    "published_at.start": "2021-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?topic.id=metaverse&published_at.start=2021-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Topic sentiment comparison across sources ​

This query compares how different sources cover a specific topic.

python
params = {
    "topic.id": "electric_vehicles",
    "source.domain": "cnn.com,foxnews.com,bbc.com",
    "sort.by": "sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=electric_vehicles&source.domain=cnn.com,foxnews.com,bbc.com&sort.by=sentiment.overall.score&api_key=YOUR_API_KEY"

Cross-regional topic impact analysis ​

This query examines how cybersecurity threats are reported across different countries with advanced filtering by relevance and credibility.

python
params = {
    "topic.id": "cybersecurity",
    "source.country.code": "us,il,ru,cn",
    "source.rank.opr.min": "0.7",
    "title": "threat,attack,breach,hack",
    "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?topic.id=cybersecurity&source.country.code=us,il,ru,cn&source.rank.opr.min=0.7&title=threat,attack,breach,hack&published_at.start=2023-01-01&sort.by=source.country.code,sentiment.overall.score&api_key=YOUR_API_KEY"

Topic and brand intersectional sentiment analysis ​

This query analyzes the sentiment around specific brands within the electric vehicle topic space, filtered by visual content.

python
params = {
    "topic.id": "electric_vehicles",
    "brand.name": "Tesla,Rivian,Lucid,Nio",
    "media.images.count": "2",
    "published_at.start": "2023-01-01",
    "sort.by": "brand.name,sentiment.overall.score",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?topic.id=electric_vehicles&brand.name=Tesla,Rivian,Lucid,Nio&media.images.count=2&published_at.start=2023-01-01&sort.by=brand.name,sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"