APITube Documentation

Appearance

Sign inGet started

Entity Query Examples ​

Getting news about a specific entity ​

This query retrieves news articles about a specific entity by ID.

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

Getting news about multiple entities ​

This query retrieves news articles about multiple entities.

python
params = {
    "entity.id": "1278268,1309610",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1309610&api_key=YOUR_API_KEY"

Filtering by including and excluding entities ​

This query retrieves articles about one entity and excludes another.

python
params = {
    "entity.id": "1278268",
    "ignore.entity.id": "1309610",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268&ignore.entity.id=1309610&api_key=YOUR_API_KEY"

Entity correlation analysis ​

This query analyzes correlation between multiple entities, sorting by sentiment score.

python
params = {
    "entity.id": "1278268,1333257",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1333257&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Tracking entity mentions over time ​

This query allows tracking mentions of a specific entity in chronological order.

python
params = {
    "entity.id": "1309610",
    "per_page": "100",
    "sort.by": "published_at",
    "sort.order": "asc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1309610&per_page=100&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Entity impact on market sentiment ​

This query analyzes entity influence on market sentiment in the business category.

python
params = {
    "category.id": "medtop:04000000",
    "sentiment.overall.polarity": "positive",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?category.id=medtop:04000000&sentiment.overall.polarity=positive&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Cross-lingual entity reputation tracking ​

This query tracks how a specific entity is perceived across different languages.

python
params = {
    "entity.id": "1309610",
    "language.code": "en,fr,de",
    "sort.by": "language.code,sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1309610&language.code=en,fr,de&sort.by=language.code,sentiment.overall.score&api_key=YOUR_API_KEY"

Multi-entity competitive analysis with media richness ​

This query compares multiple competing entities with requirements for visual content and source authority, focusing on recent innovation coverage.

python
params = {
    "entity.id": "1278268,1309610,1333257",
    "title": "innovation,technology,development",
    "media.images.count": "1",
    "sort.by": "entity.id,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1309610,1333257&title=innovation,technology,development&media.images.count=1&sort.by=entity.id,published_at&api_key=YOUR_API_KEY"