curl --request POST \
--url https://api.bigdata.com/v1/entity-sentiment/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
},
"timestamp": {
"start": "2025-01-01",
"end": "2025-01-20"
}
}
'import requests
url = "https://api.bigdata.com/v1/entity-sentiment/"
payload = {
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
},
"timestamp": {
"start": "2025-01-01",
"end": "2025-01-20"
}
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
identifier: {type: 'rp_entity_id', value: '4A6F00'},
timestamp: {start: '2025-01-01', end: '2025-01-20'}
})
};
fetch('https://api.bigdata.com/v1/entity-sentiment/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bigdata.com/v1/entity-sentiment/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identifier' => [
'type' => 'rp_entity_id',
'value' => '4A6F00'
],
'timestamp' => [
'start' => '2025-01-01',
'end' => '2025-01-20'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bigdata.com/v1/entity-sentiment/"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/entity-sentiment/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/entity-sentiment/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}"
response = http.request(request)
puts response.read_body{
"results": {
"name": "<string>",
"id": "<string>",
"values": [
{
"date": "<string>",
"daily_sentiment": 0.017404,
"sentiment_pressure": 0.217784,
"abnormal_media_attention": -0.833533
}
]
},
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
},
"errors": [
{
"message": "<string>"
}
]
}{
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Too many requests. Please try again later.",
"statusCode": 429
}{
"message": "Internal Server Error",
"statusCode": 500
}Entity Sentiment
Returns a time series of daily sentiment metrics for a single entity over a specified date range. Sentiment is a quantified signal derived from unstructured text using rule-based and machine-learning methods, indicating likely positive or negative market impact. The response includes daily_sentiment (mean sentiment), sentiment_pressure (abnormal sentiment intensity), and abnormal_media_attention (abnormal media volume).
curl --request POST \
--url https://api.bigdata.com/v1/entity-sentiment/ \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
},
"timestamp": {
"start": "2025-01-01",
"end": "2025-01-20"
}
}
'import requests
url = "https://api.bigdata.com/v1/entity-sentiment/"
payload = {
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
},
"timestamp": {
"start": "2025-01-01",
"end": "2025-01-20"
}
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
identifier: {type: 'rp_entity_id', value: '4A6F00'},
timestamp: {start: '2025-01-01', end: '2025-01-20'}
})
};
fetch('https://api.bigdata.com/v1/entity-sentiment/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bigdata.com/v1/entity-sentiment/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'identifier' => [
'type' => 'rp_entity_id',
'value' => '4A6F00'
],
'timestamp' => [
'start' => '2025-01-01',
'end' => '2025-01-20'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bigdata.com/v1/entity-sentiment/"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/entity-sentiment/")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/entity-sentiment/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n },\n \"timestamp\": {\n \"start\": \"2025-01-01\",\n \"end\": \"2025-01-20\"\n }\n}"
response = http.request(request)
puts response.read_body{
"results": {
"name": "<string>",
"id": "<string>",
"values": [
{
"date": "<string>",
"daily_sentiment": 0.017404,
"sentiment_pressure": 0.217784,
"abnormal_media_attention": -0.833533
}
]
},
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
},
"errors": [
{
"message": "<string>"
}
]
}{
"message": "Bad Request Error",
"statusCode": 400
}{
"message": "Too many requests. Please try again later.",
"statusCode": 429
}{
"message": "Internal Server Error",
"statusCode": 500
}Authorizations
Body
Query model for time series sentiment request.
Object specifying which identifier you are using to request the sentiment data. You must supply one type and its corresponding value or a list of entities.
Show child attributes
Show child attributes
The time range for retrieving sentiment data. The expected date format is 'YYYY-MM-DD', for example, '2025-09-02'.
Show child attributes
Show child attributes
Response
Successful Response
Public API response for time series sentiment query.
Sentiment time series results
Show child attributes
Show child attributes
Request metadata including request ID and timestamp.
Show child attributes
Show child attributes
List of errors encountered while fetching data.
Show child attributes
Show child attributes
Was this page helpful?