Track your competitors and see whether coverage is positive, negative, or neutral

Track multiple competitors. See whether coverage is positive, negative, or neutral. Filter by source quality and view data over time

Input parameters

ParameterDescriptionTypeDefaultRequired
organization.nameMultiple competitors (comma-separated).stringYes
category.idCategory filter.stringYes
published_at.startStart date for analysis period.stringYes
sort.bySort by sentiment score.stringYes
sort.orderDescending order.stringYes
source.rank.opr.minMinimum source quality.stringYes
is_duplicateExclude duplicates.integer0Yes
api_keyYour API keystringYes
per_pageMaximum number of articles to retrieveinteger30No

Workflow examples

Competitive intelligence analysis:
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=Tesla,Microsoft,Amazon&category.id=medtop:13000000&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&source.rank.opr.min=5&is_duplicate=0&api_key=YOUR_API_KEY"
Cross-industry innovation analysis:
curl -X GET "https://api.apitube.io/v1/news/everything?title=innovation&sentiment.overall.polarity=positive&published_at.start=2023-01-01&published_at.end=2023-01-31&category.id=medtop:04000000&api_key=YOUR_API_KEY"
Track whether organization coverage is positive, negative, or neutral during financial events:
curl -X GET "https://api.apitube.io/v1/news/everything?organization.name=JPMorgan%20Chase&published_at.start=2023-04-01&published_at.end=2023-04-30&sort.by=published_at&sort.order=asc&category.id=medtop:04000000&api_key=YOUR_API_KEY"

Related examples

Recipe for cURL

curl --location --globoff --request POST 'https://api.apitube.io/v1/news/everything?organization.name=Tesla%2CMicrosoft%2CAmazon&category.id=medtop%3A13000000&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&source.rank.opr.min=5&is_duplicate=0&api_key=YOUR_API_KEY&per_page=30' \
--header 'Content-Type: application/json'

Recipe for Python

import requests

url = "https://api.apitube.io/v1/news/everything"

querystring = {
    "organization.name": "Tesla,Microsoft,Amazon",
    "category.id": "medtop:13000000",
    "published_at.start": "2023-01-01",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "source.rank.opr.min": 5,
    "is_duplicate": 0,
    "api_key": "YOUR_API_KEY",
    "per_page": 30
}
response = requests.request("GET", url, params=querystring)

print(response.text)

Recipe for Javascript

import axios from "axios"

const options = {
		method: 'GET',
		url: 'https://api.apitube.io/v1/news/everything',
		params: {
    "organization.name": "Tesla,Microsoft,Amazon",
    "category.id": "medtop:13000000",
    "published_at.start": "2023-01-01",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "source.rank.opr.min": 5,
    "is_duplicate": 0,
    "api_key": "YOUR_API_KEY",
    "per_page": 30
}};

axios.request(options).then(function (response) {
		console.log(response.data);
}).catch(function (error) {
		console.error(error);
});

Recipe for PHP

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();
$response = $client->request('GET', 'https://api.apitube.io/v1/news/everything', [
	'query' => [
    'organization.name' => 'Tesla,Microsoft,Amazon',
    'category.id' => 'medtop:13000000',
    'published_at.start' => '2023-01-01',
    'sort.by' => 'sentiment.overall.score',
    'sort.order' => 'desc',
    'source.rank.opr.min' => 5,
    'is_duplicate' => 0,
    'api_key' => 'YOUR_API_KEY',
    'per_page' => 30,
],
]);

echo $response->getBody();

Recipe for Java

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
		.url("https://api.apitube.io/v1/news/everything?organization.name=Tesla%2CMicrosoft%2CAmazon&category.id=medtop%3A13000000&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&source.rank.opr.min=5&is_duplicate=0&api_key=YOUR_API_KEY&per_page=30")
		.method("POST", body)
		.addHeader("Content-Type", "application/json")
		.build();
Response response = client.newCall(request).execute();
		
  • CNN
  • Techcrunch
  • Vox
  • Apple
  • Microsoft
  • IBM
  • Bloomberg
  • Spotify
We use cookies

By clicking "Accept", you agree to cookies on your device for the site to work and for analytics.