Quick Start

Get Started in Three Steps

1. Obtain your API key

Sign up or log in at insight.apeek.io, navigate to the API Access section, and click Generate Key. This key authenticates every request you make. Treat it like a password — never share it publicly or commit it to version control.

2. Make your first request

Every request requires four query parameters: api_key, series, date_from, and date_to.

cURL

curl "https://api.apeek.io/api/v1/economic-data/ui_weekly_claims?series=initial_claims_sa&date_from=2025-01-01&date_to=2026-01-01&api_key=your_api_key_here"

Python

import requests

url = "https://api.apeek.io/api/v1/economic-data/ui_weekly_claims"
params = {
    "series": "initial_claims_sa,continued_claims_sa",
    "date_from": "2025-01-01",
    "date_to": "2026-01-01",
    "api_key": "your_api_key_here"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

3. Read the response

Every successful response follows the same structure. See the Response Format page for full details.

{
  "status": "OK",
  "message": "Data retrieved successfully",
  "meta": {
    "schema_version": "1.0",
    "frequency": "Weekly",
    "fields": {
      "date": "string (YYYY-MM-DD)",
      "series": "string",
      "value": "numerical string"
    }
  },
  "pagination": {
    "count": "100",
    "next_url": "/economic-data/ui_weekly_claims?series=initial_claims_sa,continued_claims_sa&date_from=2025-01-01&date_to=2026-01-01&token_id=7c1b453e..."
  },
  "data": [
    {
      "date": "2025-01-04",
      "series": "initial_claims_sa",
      "value": "211000"
    }
  ]
}

If the result set exceeds a single page, the next_url field provides a ready-to-use path for the next page. Append it to the base URL and repeat until next_url is null. See Pagination for details.

What's next

• Authentication — Rate limits and security practices
• Data Endpoints — All endpoints and their available series codes
• Examples — Code samples in Python, cURL, JavaScript, and R
• Errors — HTTP status codes and error response bodies