APITube Documentation

Appearance

Sign inGet started

Organization Query Examples ​

Search for news about a specific organization ​

This query retrieves news articles about Google.

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

Search for news about multiple organizations ​

This query retrieves news articles about Google and Apple.

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

Include one organization and exclude another ​

This query retrieves news articles about Google but excludes articles about Apple.

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

Competitive intelligence analysis ​

This query compares news coverage of Tesla, Ford, and Toyota in technology and finance categories.

python
params = {
    "organization.name": "Tesla,Ford,Toyota",
    "category.id": "4,6",
    "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?organization.name=Tesla,Ford,Toyota&category.id=4,6&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Organization sentiment tracking during financial events ​

This query tracks sentiment of JP Morgan coverage during a financial reporting month.

python
params = {
    "organization.name": "JP Morgan",
    "published_at.start": "2023-04-01",
    "published_at.end": "2023-04-30",
    "sort.by": "published_at",
    "sort.order": "asc",
    "category.id": "2",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=JP%20Morgan&published_at.start=2023-04-01&published_at.end=2023-04-30&sort.by=published_at&sort.order=asc&category.id=2&api_key=YOUR_API_KEY"

Corporate social responsibility coverage ​

This query analyzes positive coverage of tech companies' sustainability initiatives.

python
params = {
    "organization.name": "Microsoft,Google,Amazon",
    "title": "sustainability,ESG,green",
    "published_at.start": "2023-01-01",
    "sentiment.overall.polarity": "positive",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Microsoft,Google,Amazon&title=sustainability,ESG,green&published_at.start=2023-01-01&sentiment.overall.polarity=positive&api_key=YOUR_API_KEY"

Executive leadership transition analysis ​

This query tracks coverage of Disney's CEO changes over time.

python
params = {
    "organization.name": "Disney",
    "title": "CEO",
    "published_at.start": "2022-01-01",
    "published_at.end": "2023-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?organization.name=Disney&title=CEO&published_at.start=2022-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Cross-regional organizational reputation analysis ​

This query compares how multinational organizations are perceived across different global markets with language-specific coverage and sentiment analysis.

python
params = {
    "organization.name": "Volkswagen,Toyota,General Motors",
    "source.country.code": "de,jp,us",
    "language.code": "de,ja,en",
    "published_at.start": "2023-01-01",
    "sort.by": "organization.name,source.country.code,sentiment.overall.score",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Volkswagen,Toyota,General%20Motors&source.country.code=de,jp,us&language.code=de,ja,en&published_at.start=2023-01-01&sort.by=organization.name,source.country.code,sentiment.overall.score&api_key=YOUR_API_KEY"

Organization industry disruption impact tracking ​

This query analyzes how traditional financial institutions are responding to fintech disruption, with filtering for high-quality sources and relevant context.

python
params = {
    "organization.name": "Goldman Sachs,JPMorgan,Bank of America",
    "title": "fintech,blockchain,cryptocurrency,digital banking",
    "source.rank.opr.min": "0.7",
    "category.id": "2",
    "published_at.start": "2023-01-01",
    "sort.by": "organization.name,published_at",
    "api_key": "YOUR_API_KEY"
}
shell
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Goldman%20Sachs,JPMorgan,Bank%20of%20America&title=fintech,blockchain,cryptocurrency,digital%20banking&source.rank.opr.min=0.7&category.id=2&published_at.start=2023-01-01&sort.by=organization.name,published_at&api_key=YOUR_API_KEY"