Most mentioned entities with faceting

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

Invoerparameter

ParameterDescriptionTypeDefaultRequired
has_entitiesFilter articles with any entities.integer1Yes
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?has_entities=1&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"

Recept voor cURL

curl --location --globoff --request POST 'https://api.apitube.io/v1/news/everything?has_entities=1&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'

Recept voor Python

import requests

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

querystring = {
    "has_entities": 1,
    "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)

Recept voor Javascript

import axios from "axios"

const options = {
		method: 'GET',
		url: 'https://api.apitube.io/v1/news/everything',
		params: {
    "has_entities": 1,
    "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);
});

Recept voor PHP

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();
$response = $client->request('GET', 'https://api.apitube.io/v1/news/everything', [
	'query' => [
    'has_entities' => 1,
    '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();

Recept voor 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?has_entities=1&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