v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

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

Request body

Response

Successful Response

Example response

{
  "results": [
    {
      "rp_entity_id": "4A6F00",
      "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
    }
  ]
}