Most mentioned entities with faceting
Find most mentioned entities in articles with faceting, entity filters, and source quality
Parámetros de entrada
| Parameter | Description | Type | Default | Required |
|---|---|---|---|---|
| has_entities | Filter articles with any entities. | integer | 1 | Yes |
| facet | Enable faceting. | boolean | true | Yes |
| facet.field | Field to facet on (entity.id). | string | Yes | |
| facet.limit | Maximum facet values. | integer | 20 | Yes |
| is_verified_source | Filter verified sources. | integer | 1 | Yes |
| source.rank.opr.min | Minimum source quality. | string | Yes | |
| published_at.start | Start date filter. | string | Yes | |
| api_key | Your API key. | string | Yes | |
| per_page | Maximum number of articles to retrieve. | integer | 30 | No |
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"
Receta para 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'
Receta para 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)
Receta para 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);
});
Receta para 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();
Receta para 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();