Brand reputation analysis across markets

Check whether brand coverage is positive, negative, or neutral across multiple countries, filtering by source quality and date range

Input parameters

ParameterDescriptionTypeDefaultRequired
titleBrand name to search for in article titles.stringYes
source.country.codeMultiple country codes (comma-separated).stringYes
sort.bySort by sentiment score.stringYes
sort.orderDescending order.stringYes
published_at.startStart date for analysis period.stringYes
source.rank.opr.minMinimum source quality rank.stringYes
api_keyYour API keystringYes
per_pageMaximum number of articles to retrieveinteger25No

Workflow examples

Request for brand reputation analysis across markets:
curl -X GET "https://api.apitube.io/v1/news/everything?title=Samsung&source.country.code=us,kr,in&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&published_at.end=2023-01-31&source.rank.opr.min=6&api_key=YOUR_API_KEY"
Request for brand sponsorship impact analysis:
curl -X GET "https://api.apitube.io/v1/news/everything?title=Rolex,sponsorship,tournament&published_at.start=2023-01-01&published_at.end=2023-01-31&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"
Request for brand crisis management tracking:
curl -X GET "https://api.apitube.io/v1/news/everything?title=Boeing%20737%20MAX&sentiment.overall.polarity=negative&published_at.start=2019-03-01&published_at.end=2019-03-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"
See whether brand coverage is positive, negative, or neutral across multiple languages:
curl -X GET "https://api.apitube.io/v1/news/everything?language.code=en,fr,de,ja&title=Netflix&sentiment.overall.polarity=positive&published_at.start=2023-01-01&published_at.end=2023-01-31&sort.by=published_at&api_key=YOUR_API_KEY"

Related examples

Recipe for cURL

curl --location --globoff --request POST 'https://api.apitube.io/v1/news/everything?title=Samsung&source.country.code=us%2Ckr%2Cin&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&source.rank.opr.min=6&api_key=YOUR_API_KEY&per_page=25' \
--header 'Content-Type: application/json'

Recipe for Python

import requests

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

querystring = {
    "title": "Samsung",
    "source.country.code": "us,kr,in",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "published_at.start": "2023-01-01",
    "source.rank.opr.min": 6,
    "api_key": "YOUR_API_KEY",
    "per_page": 25
}
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: {
    "title": "Samsung",
    "source.country.code": "us,kr,in",
    "sort.by": "sentiment.overall.score",
    "sort.order": "desc",
    "published_at.start": "2023-01-01",
    "source.rank.opr.min": 6,
    "api_key": "YOUR_API_KEY",
    "per_page": 25
}};

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' => [
    'title' => 'Samsung',
    'source.country.code' => 'us,kr,in',
    'sort.by' => 'sentiment.overall.score',
    'sort.order' => 'desc',
    'published_at.start' => '2023-01-01',
    'source.rank.opr.min' => 6,
    'api_key' => 'YOUR_API_KEY',
    'per_page' => 25,
],
]);

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?title=Samsung&source.country.code=us%2Ckr%2Cin&sort.by=sentiment.overall.score&sort.order=desc&published_at.start=2023-01-01&source.rank.opr.min=6&api_key=YOUR_API_KEY&per_page=25")
		.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.