API поиска · SEC

API поиска по документам SEC и финансам США

Запрашивайте документы SEC (10-K, 10-Q, 8-K), стенограммы отчётных конференц-звонков США и статистику акций из одного эндпоинта. Заранее подготовленный JSON для AI-due diligence, фундаментального анализа и финансового RAG.

120 кредитов / вызов30 запр./минPOST /api/search/sec

Попробуйте поиск по SEC вживую

Введите свой API-ключ и выполните настоящий запрос к рабочему эндпоинту.

API Authentication Required
Enter your API key to access this service. All API calls require authentication.

Нет API-ключа?

Войдите в аккаунт, чтобы создавать и управлять API-ключами.

5 примеров запросов — нажмите для подстановки

API Integration Guide

Learn how to integrate this API into your applications with code examples and detailed documentation.

API Overview
Семантический поиск по документам SEC EDGAR, стенограммам отчётов США и статистике акций. Возвращает ранжированные фрагменты с URL источников, готовые для последующих LLM.
POST
/api/search/sec

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/sec
Parameters
Required and optional parameters for this API
query
required
string

Natural-language search query

max_num_results
optional
integer

1–5, default 5

relevance_threshold
optional
number

0.0–1.0 quality filter

country_code
optional
string

ISO country code (e.g. US, GB)

start_date
optional
string

ISO date YYYY-MM-DD

end_date
optional
string

ISO date YYYY-MM-DD

Code Examples
Copy and paste these examples to quickly integrate the API into your application

cURL Request

curl -X POST "https://www.apipick.com/api/search/sec" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Latest Nvidia statistics",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
Replace YOUR_API_KEY with your actual API key
Response Example
Example response from the API

JSON Response

{
  "query": "Latest Nvidia statistics",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 120,
  "remaining_credits": 99
}
Integration Tips

Best Practices

  • • Always include x-api-key header
  • • Always handle errors gracefully
  • • Validate input data before sending
  • • Use HTTPS for secure communication
  • • Cache responses when appropriate

Response Headers

  • • Content-Type: application/json
  • • x-api-key: Required for authentication
  • • Status codes: 200 (success), 400 (error), 401 (unauthorized)
  • • No rate limiting applied

Rate Limits

⏱️

Request Rate

30req / min

Per API key, per endpoint. Sliding 60-second window.

🔀

Concurrency

3concurrent

Max simultaneous in-flight requests per API key.

Response Headers

X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)

429 Too Many Requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

Часто задаваемые вопросы

Почему 120 кредитов за вызов вместо 15 у веб-поиска?

Документы SEC EDGAR, стенограммы отчётов США и статистика акций — проприетарные данные, дорогие в лицензировании и требующие постоянного обслуживания индекса. Цена в 120 кредитов (≈ $0.12 за вызов) это отражает — и всё равно это малая часть того, что берут специализированные SEC-аналитические платформы за API-лицензию.

Какие типы документов охвачены?

Все документы EDGAR — 10-K, 10-Q, 8-K, S-1, доверенности и т.д. — плюс стенограммы отчётных конференц-звонков США и вычисленная статистика акций. Передайте тикер, название компании или запрос на естественном языке.

Можно получить полный текст документа?

Результаты содержат фрагменты с URL источников. Чтобы получить документ целиком, вызовите POST /api/extract по URL — получите чистый Markdown, готовый для LLM.

Фильтрация по дате?

Да. Передайте start_date и end_date в YYYY-MM-DD, чтобы ограничить результаты конкретным окном подачи документов.

Схема инструмента для OpenAI / Claude?

GET /api/search/sec/tool-schema возвращает готовые к вставке определения OpenAI function и tool use Claude.