Find which organizations and locations a person is mentioned with

Input parameters

Workflow examples

Find which organizations a person is mentioned with:

curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&organization.name=Tesla&published_at.start=2024-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY"

See whether coverage of a person is positive, negative, or neutral across different sources:

curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&source.domain=cnn.com,foxnews.com,bbc.com&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Track controversial coverage of a public figure over time:

curl -X GET "https://api.apitube.io/v1/news/everything?person.name=Elon%20Musk&sentiment.overall.polarity=negative&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"

Multi-location business impact study:

curl -X GET "https://api.apitube.io/v1/news/everything?location.name=United%20States,China,India&category.id=medtop:04000000&organization.name=Apple,Google,Microsoft&published_at.start=2023-01-01&api_key=YOUR_API_KEY"

Related examples

• Track your competitors
• Brand reputation analysis
• Track how often people, companies, or places appear together
• Get articles about Elon Musk with a positive tone
• Sort by engagement score

Recipe for cURL

curl --location --globoff --request POST 'https://api.apitube.io/v1/news/everything?person.name=Elon+Musk&organization.name=Tesla&published_at.start=2024-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY&per_page=20' \
--header 'Content-Type: application/json'

Recipe for Python

import requests

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

querystring = {
    "person.name": "Elon Musk",
    "organization.name": "Tesla",
    "published_at.start": "2024-01-01",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY",
    "per_page": 20
}
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: {
    "person.name": "Elon Musk",
    "organization.name": "Tesla",
    "published_at.start": "2024-01-01",
    "sort.by": "published_at",
    "sort.order": "desc",
    "api_key": "YOUR_API_KEY",
    "per_page": 20
}};

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' => [
    'person.name' => 'Elon Musk',
    'organization.name' => 'Tesla',
    'published_at.start' => '2024-01-01',
    'sort.by' => 'published_at',
    'sort.order' => 'desc',
    'api_key' => 'YOUR_API_KEY',
    'per_page' => 20,
],
]);

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?person.name=Elon+Musk&organization.name=Tesla&published_at.start=2024-01-01&sort.by=published_at&sort.order=desc&api_key=YOUR_API_KEY&per_page=20")
		.method("POST", body)
		.addHeader("Content-Type", "application/json")
		.build();
Response response = client.newCall(request).execute();