APITube Documentation

Appearance

Sign inGet started

Media Query Examples ​

Search for articles with specific media counts ​

This query retrieves news articles containing at least 2 images and 1 video.

python
params = {
    "media.images.count": "2",
    "media.videos.count": "1",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&media.videos.count=1&api_key=YOUR_API_KEY"

Filter articles by image dimensions ​

This query retrieves news articles with images of specific dimensions.

python
params = {
    "media.images.width.min": "200",
    "media.images.width.max": "800",
    "media.images.height.min": "200",
    "media.images.height.max": "800",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.width.min=200&media.images.width.max=800&media.images.height.min=200&media.images.height.max=800&api_key=YOUR_API_KEY"

Rich media content curation ​

This query finds technology news with rich media content.

python
params = {
    "media.images.count": "2",
    "category.id": "medtop:13000000",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&category.id=medtop:13000000&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"

High-quality visual news aggregation ​

This query collects high-quality visually rich positive news in technology category.

python
params = {
    "media.images.width.min": "800",
    "media.images.height.min": "600",
    "media.images.count": "1",
    "sentiment.overall.polarity": "positive",
    "category.id": "medtop:13000000",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.width.min=800&media.images.height.min=600&media.images.count=1&sentiment.overall.polarity=positive&category.id=medtop:13000000&api_key=YOUR_API_KEY"

Interactive media content curation ​

This query finds articles with rich interactive media content.

python
params = {
    "media.images.count": "2",
    "category.id": "medtop:13000000",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&category.id=medtop:13000000&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"

Image-rich product reviews ​

This query finds visually rich product reviews.

python
params = {
    "media.images.count": "2",
    "title": "review",
    "category.id": "medtop:13000000",
    "organization.name": "Apple,Google",
    "sort.by": "media.images.count",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=2&title=review&category.id=medtop:13000000&organization.name=Apple,Google&sort.by=media.images.count&sort.order=desc&api_key=YOUR_API_KEY"

Cross-platform visual content comparison ​

This query compares visual content richness between different news platforms covering the same topics, focusing on high-authority sources.

python
params = {
    "media.images.count": "1",
    "source.domain": "theguardian.com,foxnews.com,nytimes.com",
    "topic.id": "industry.ai_news",
    "sort.by": "source.domain,media.images.count",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=1&source.domain=theguardian.com,foxnews.com,nytimes.com&topic.id=industry.ai_news&sort.by=source.domain,media.images.count&api_key=YOUR_API_KEY"

Multimedia organization announcement coverage ​

This query analyzes media-rich coverage of product announcements across various organizations, filtering for presentation quality and positive sentiment.

python
params = {
    "media.images.count": "1",
    "organization.name": "Apple,Google,Microsoft,Amazon",
    "title": "launch,announce,unveil,reveal",
    "sentiment.overall.polarity": "positive",
    "sort.by": "organization.name,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=1&organization.name=Apple,Google,Microsoft,Amazon&title=launch,announce,unveil,reveal&sentiment.overall.polarity=positive&sort.by=organization.name,published_at&api_key=YOUR_API_KEY"