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": "3",
    "media.videos.count": "1",
    "category.id": "4",
    "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?media.images.count=3&media.videos.count=1&category.id=4&published_at.start=2023-01-01&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 and sports categories.

python
params = {
    "media.images.width.min": "1200",
    "media.images.height.min": "800",
    "media.images.count": "2",
    "sentiment.overall.polarity": "positive",
    "category.id": "4,7",
    "source.rank.opr.min": "0.7",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.width.min=1200&media.images.height.min=800&media.images.count=2&sentiment.overall.polarity=positive&category.id=4,7&source.rank.opr.min=0.7&api_key=YOUR_API_KEY"

Video content analysis for educational topics ​

This query finds educational video content.

python
params = {
    "media.videos.count": "2",
    "category.id": "15",
    "title": "education,learning,tutorial",
    "published_at.start": "2023-01-01",
    "sort.by": "media.videos.count",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.videos.count=2&category.id=15&title=education,learning,tutorial&published_at.start=2023-01-01&sort.by=media.videos.count&sort.order=desc&api_key=YOUR_API_KEY"

Interactive media content curation ​

This query finds articles with rich interactive media content.

python
params = {
    "media.images.count": "3",
    "media.videos.count": "1",
    "media.interactive.count": "1",
    "category.id": "4,7",
    "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?media.images.count=3&media.videos.count=1&media.interactive.count=1&category.id=4,7&published_at.start=2023-01-01&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": "4",
    "title": "review",
    "category.id": "4",
    "brand.name": "iPhone,Samsung",
    "published_at.start": "2023-01-01",
    "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=4&title=review&category.id=4&brand.name=iPhone,Samsung&published_at.start=2023-01-01&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": "2",
    "media.videos.count": "1",
    "source.domain": "cnn.com,bbc.com,theguardian.com,nytimes.com",
    "source.rank.opr.min": "0.8",
    "topic.id": "artificial_intelligence",
    "published_at.start": "2023-01-01",
    "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=2&media.videos.count=1&source.domain=cnn.com,bbc.com,theguardian.com,nytimes.com&source.rank.opr.min=0.8&topic.id=artificial_intelligence&published_at.start=2023-01-01&sort.by=source.domain,media.images.count&api_key=YOUR_API_KEY"

Multimedia brand announcement coverage ​

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

python
params = {
    "media.images.count": "3",
    "media.videos.count": "2",
    "media.images.width.min": "1000",
    "brand.name": "Apple,Samsung,Google,Microsoft",
    "title": "launch,announce,unveil,reveal",
    "sentiment.overall.polarity": "positive",
    "published_at.start": "2023-01-01",
    "sort.by": "brand.name,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?media.images.count=3&media.videos.count=2&media.images.width.min=1000&brand.name=Apple,Samsung,Google,Microsoft&title=launch,announce,unveil,reveal&sentiment.overall.polarity=positive&published_at.start=2023-01-01&sort.by=brand.name,published_at&api_key=YOUR_API_KEY"