APITube Documentation

Appearance

Sign inGet started

Brand Query Examples ​

Search for news about a specific brand ​

This query retrieves news articles about Nike.

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

Search for news about multiple brands ​

This query retrieves news articles about Nike and Adidas.

python
params = {
    "brand.name": "Nike,Adidas",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike,Adidas&api_key=YOUR_API_KEY"

Include one brand and exclude another ​

This query retrieves news articles about Nike but excludes articles about Adidas.

python
params = {
    "brand.name": "Nike",
    "ignore.brand.name": "Adidas",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Nike&ignore.brand.name=Adidas&api_key=YOUR_API_KEY"

Brand reputation analysis across markets ​

This query compares Samsung's reputation in different global markets.

python
params = {
    "brand.name": "Samsung",
    "source.country.code": "us,kr,in",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "published_at.start": "2023-01-01",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Samsung&source.country.code=us,kr,in&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&api_key=YOUR_API_KEY"

Product launch media coverage tracking ​

This query tracks coverage of the iPhone 15 launch.

python
params = {
    "brand.name": "Apple",
    "title_pattern": "iPhone 15",
    "published_at.start": "2023-09-01",
    "published_at.end": "2023-10-31",
    "sort.by": "published_at",
    "sort.order": "asc",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?brand.name=Apple&title_pattern=iPhone%2015&published_at.start=2023-09-01&published_at.end=2023-10-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Brand sponsorship impact analysis ​

This query analyzes luxury watch brands' sponsorship impact.

python
params = {
    "brand.name": "Rolex,Omega,Tag Heuer",
    "title": "sponsorship,tournament,championship",
    "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?brand.name=Rolex,Omega,Tag%20Heuer&title=sponsorship,tournament,championship&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Brand crisis management tracking ​

This query tracks Boeing's crisis management during the 737 MAX incidents.

python
params = {
    "brand.name": "Boeing",
    "title": "737 MAX",
    "sentiment.overall.polarity": "negative",
    "published_at.start": "2019-03-01",
    "published_at.end": "2020-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?brand.name=Boeing&title=737%20MAX&sentiment.overall.polarity=negative&published_at.start=2019-03-01&published_at.end=2020-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"