Earnings Surprises
curl --request POST \
--url https://api.bigdata.com/v1/latest-surprise/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
}
}
'import requests
url = "https://api.bigdata.com/v1/latest-surprise/query"
payload = { "identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
} }
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'}})
};
fetch('https://api.bigdata.com/v1/latest-surprise/query', 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/latest-surprise/query",
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'
]
]),
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/latest-surprise/query"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\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/latest-surprise/query")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/latest-surprise/query")
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}"
response = http.request(request)
puts response.read_body{
"results": [
{
"rp_entity_id": "<string>",
"target_identifier_id": "GOOGL",
"reporting_date": "2025-07-23",
"eps_actual": 2.31,
"eps_estimated": 2.15,
"revenue_actual": 96428000000,
"revenue_estimated": 99697450760,
"last_updated": "2025-09-16",
"eps_surprise_pct": 7.441,
"revenue_surprise_pct": -3.379
}
],
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
}
}Analyst Estimates
Earnings Surprises
The Earnings Surprises API allows users to retrieve the most recent quarterly earnings surprise data for a specific company. This endpoint provides actual versus estimated earnings per share (EPS) and revenue (sales), highlighting whether the company has beaten, missed, or met expectations.
POST
/
v1
/
latest-surprise
/
query
Earnings Surprises
curl --request POST \
--url https://api.bigdata.com/v1/latest-surprise/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
}
}
'import requests
url = "https://api.bigdata.com/v1/latest-surprise/query"
payload = { "identifier": {
"type": "rp_entity_id",
"value": "4A6F00"
} }
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'}})
};
fetch('https://api.bigdata.com/v1/latest-surprise/query', 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/latest-surprise/query",
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'
]
]),
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/latest-surprise/query"
payload := strings.NewReader("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\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/latest-surprise/query")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"identifier\": {\n \"type\": \"rp_entity_id\",\n \"value\": \"4A6F00\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bigdata.com/v1/latest-surprise/query")
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}"
response = http.request(request)
puts response.read_body{
"results": [
{
"rp_entity_id": "<string>",
"target_identifier_id": "GOOGL",
"reporting_date": "2025-07-23",
"eps_actual": 2.31,
"eps_estimated": 2.15,
"revenue_actual": 96428000000,
"revenue_estimated": 99697450760,
"last_updated": "2025-09-16",
"eps_surprise_pct": 7.441,
"revenue_surprise_pct": -3.379
}
],
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
}
}Authorizations
Body
application/json
Object specifying which identifier you are using to request the financial latest surprise. You must supply one type and its corresponding value.
Show child attributes
Show child attributes
Was this page helpful?
⌘I