Most mentioned entities with faceting

Find most mentioned entities in articles with faceting, entity filters, and source quality

Input parameters

ParameterDescriptionTypeDefaultRequired
facetEnable faceting.booleantrueYes
facet.fieldField to facet on (entity.id).stringYes
facet.limitMaximum facet values.integer20Yes
is_verified_sourceFilter verified sources.integer1Yes
source.rank.opr.minMinimum source quality.stringYes
published_at.startStart date filter.stringYes
api_keyYour API key.stringYes
per_pageMaximum number of articles to retrieve.integer30No

Workflow examples

Request for most mentioned entities:
curl -X GET "https://api.apitube.io/v1/news/everything?facet=true&facet.field=entity.id&facet.limit=20&api_key=YOUR_API_KEY"
Request for entity correlation analysis:
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1282301&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"

Related Examples

Recipe for cURL

curl --location --globoff --request POST 'https://api.apitube.io/v1/news/everything?facet=1&facet.field=entity.id&facet.limit=20&is_verified_source=1&source.rank.opr.min=0.6&published_at.start=2024-01-01&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 = {
    "facet": true,
    "facet.field": "entity.id",
    "facet.limit": 20,
    "is_verified_source": 1,
    "source.rank.opr.min": 0.6,
    "published_at.start": "2024-01-01",
    "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: {
    "facet": true,
    "facet.field": "entity.id",
    "facet.limit": 20,
    "is_verified_source": 1,
    "source.rank.opr.min": 0.6,
    "published_at.start": "2024-01-01",
    "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' => [
    'facet' => 1,
    'facet.field' => 'entity.id',
    'facet.limit' => 20,
    'is_verified_source' => 1,
    'source.rank.opr.min' => 0.6,
    'published_at.start' => '2024-01-01',
    '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?facet=1&facet.field=entity.id&facet.limit=20&is_verified_source=1&source.rank.opr.min=0.6&published_at.start=2024-01-01&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 the storing of cookies on your device for functional and analytics.