Skip to main content
POST
/
api
/
v1
/
search
/
Search documents and content
curl --request POST \
  --url https://sacra.com/api/v1/search/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "limit": 10,
  "offset": 0,
  "date_gte": "<string>",
  "date_lte": "<string>"
}
'
{
  "query": "kraken revenue",
  "total_results": 125,
  "page": 0,
  "per_page": 10,
  "results": [
    {
      "document_id": "kraken-at-1-5b-up-128-yoy",
      "type": "document",
      "title": "Kraken at $1.5B up 128% YoY",
      "excerpt": "After the crypto decline in 2022-2023, Kraken posted a Sacra-estimated $1.5B in revenue for 2024...",
      "url": "/research/kraken-at-1-5b-up-128-yoy",
      "date": "2025-03-06T00:00:00-05:00",
      "highlight": {
        "title": "<em>Kraken</em> at $1.5B up 128% YoY",
        "content": "After the crypto decline, <em>Kraken</em> posted a Sacra-estimated $1.5B in <em>revenue</em>..."
      }
    },
    {
      "document_id": "kraken",
      "type": "company",
      "title": "Kraken",
      "excerpt": "",
      "url": "/kraken",
      "date": "2026-02-09T00:00:00-05:00",
      "highlight": {
        "title": "<em>Kraken</em>"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate using one of two formats:

  • Organization/user token: Token <your-token>
  • Stytch JWT: Bearer <your-jwt>

Body

​
query
string
required

The search term or question.

​
limit
integer
default:10

Maximum results per page (default 10, max 50).

​
offset
integer
default:0

Number of results to skip for pagination.

​
date_gte
string

Inclusive ISO date/datetime lower bound for result dates (e.g. 2025-01-01).

​
date_lte
string

Inclusive ISO date/datetime upper bound for result dates (e.g. 2025-12-31).

Response

Search results with pagination metadata.

​
query
string
required
​
total_results
integer
required

Total hits across both indices.

​
page
integer
required

Current page number (offset / limit).

​
per_page
integer
required

Results requested per page (the limit).

​
results
object[]
required