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": "314",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&api_key=YOUR_API_KEY"

Getting news about multiple entities ​

This query retrieves news articles about multiple entities.

python
params = {
    "entity.id": "314,315",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314,315&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": "314",
    "ignore.entity.id": "315",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&ignore.entity.id=315&api_key=YOUR_API_KEY"

Entity correlation analysis ​

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

python
params = {
    "entity.id": "314,315,316",
    "published_at.start": "2023-01-01",
    "published_at.end": "2023-12-31",
    "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=314,315,316&published_at.start=2023-01-01&published_at.end=2023-12-31&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": "314",
    "published_at.start": "2022-01-01",
    "published_at.end": "2023-12-31",
    "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=314&published_at.start=2022-01-01&published_at.end=2023-12-31&per_page=100&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Entity co-mention analysis ​

This query analyzes mentions of organizations together with a specific entity.

python
params = {
    "entity.id": "314",
    "entity.type": "ORGANIZATION",
    "published_at.start": "2023-01-01",
    "published_at.end": "2023-12-31",
    "sort.by": "published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314&entity.type=ORGANIZATION&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&api_key=YOUR_API_KEY"

Entity impact on market sentiment ​

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

python
params = {
    "entity.id": "314,315",
    "category.id": "2",
    "sentiment.overall.score.min": "0.7",
    "published_at.start": "2023-01-01",
    "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=314,315&category.id=2&sentiment.overall.score.min=0.7&published_at.start=2023-01-01&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 and regions with high-quality source filtering.

python
params = {
    "entity.id": "314",
    "language.code": "en,fr,de,zh,ar",
    "source.rank.opr.min": "0.8",
    "published_at.start": "2023-01-01",
    "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=314&language.code=en,fr,de,zh,ar&source.rank.opr.min=0.8&published_at.start=2023-01-01&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": "314,315,316,317",
    "title": "innovation,technology,development,breakthrough",
    "media.images.count": "2",
    "source.rank.opr.min": "0.7",
    "published_at.start": "2023-01-01",
    "sort.by": "entity.id,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=314,315,316,317&title=innovation,technology,development,breakthrough&media.images.count=2&source.rank.opr.min=0.7&published_at.start=2023-01-01&sort.by=entity.id,published_at&api_key=YOUR_API_KEY"