Aapipick
搜尋 API · SEC

SEC 文件與美股財務搜尋 API

透過單一端點查詢 SEC 文件(10-K、10-Q、8-K)、美股財報電話會議文字稿與股票統計。預先成型的 JSON,適用於 AI 驅動的實質審查、基本面分析與金融 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 金鑰。

登入管理 API 金鑰
5 條範例查詢 — 點擊載入

API Integration Guide

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

API Overview
對 SEC EDGAR 文件、美股財報文字稿與股票統計的語意搜尋。回傳排序過的段落與可供下游 LLM 使用的來源 URL。
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 的段落。要取得完整文件,可對 URL 接著呼叫 POST /api/extract — 即可取得乾淨的 Markdown 供 LLM 攝入。

日期篩選?

可以。以 YYYY-MM-DD 格式傳入 start_date 與 end_date,將結果限定於特定的提交視窗。

OpenAI / Claude 工具 schema?

GET /api/search/sec/tool-schema 回傳可直接貼上的 OpenAI 函式與 Claude 工具使用定義。