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
| Parameter | Description | Type | Default | Required |
|---|---|---|---|---|
| organization.name | Multiple competitors (comma-separated). | string | Yes | |
| category.id | Category filter. | string | Yes | |
| published_at.start | Start date for analysis period. | string | Yes | |
| sort.by | Sort by sentiment score. | string | Yes | |
| sort.order | Descending order. | string | Yes | |
| source.rank.opr.min | Minimum source quality. | string | Yes | |
| is_duplicate | Exclude duplicates. | integer | 0 | Yes |
| api_key | Your API key | string | Yes | |
| per_page | Maximum number of articles to retrieve | integer | 30 | No |
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
- Analyze whether coverage is positive, negative, or neutral across multiple dimensions
- Brand reputation analysis
- Find which organizations a person is mentioned with
- Get news with a positive tone
- Sort by engagement score
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();