API Documentation

Base URL

https://api.secblast.com/v2

Request Format

All endpoints accept GET requests with parameters provided via:

• URL query parameters - Traditional query string
• JSON body - Content-Type: application/json
• Both - Different parameters in each (cannot overlap)

URL Parameters

curl "https://api.secblast.com/v2/entity_lookup?api_key=YOUR_KEY&tickers=AAPL"

JSON Body

curl -X GET "https://api.secblast.com/v2/entity_lookup" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_KEY", "tickers": ["AAPL"]}'

Mixed (Different Parameters)

curl -X GET "https://api.secblast.com/v2/entity_lookup?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["AAPL"]}'

Response Format

All responses are JSON unless otherwise specified (e.g., PDF endpoint returns binary PDF).

{
  "count": 1,
  "entities": [...],
  "response_bytes": 1234,
  "truncated": false
}

Error Responses

Errors return a JSON object with an error field:

{
  "error": "Invalid or missing API key"
}

{
  "error": "Parameter 'tickers' specified in both URL and JSON body. Use only one input method."
}

Help Endpoint

Add help=true to any request to get parameter documentation:

curl "https://api.secblast.com/v2/entity_lookup?api_key=YOUR_KEY&help=true"