Skip to main content
POST
Earnings Pack Search

财报包搜索

URL: /v2/search/earnings-pack
方法: POST
描述: Search for earnings-related documents submitted to exchanges, including quarterly reports, semi-annual reports, and annual reports. Query is optional - if not provided, returns documents in reverse chronological order; if provided, sorts by relevance (note sort_by parameter).

请求参数

响应参数

请求示例

cURL
Python 示例

响应示例

错误响应

Authorizations

Authorization
string
header
required

Enter your Bearer token

Body

application/json

Request model for earnings-related documents search (quarterly/semi-annual/annual reports). Query is optional - if not provided, returns documents sorted by date desc.

symbols
string[]
required

Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)

query
string

Search query (optional). If not provided, returns documents sorted by date descending; if provided, results are sorted by relevance by default.

num
integer
default:10

Number of results to return

Required range: 1 <= x <= 100
start_datetime
string

Start datetime in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format

end_datetime
string

End datetime in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format

fiscal_year
string

Fiscal year filter (e.g., '2025', '2026')

fiscal_quarter
string

Fiscal quarter filter (e.g., 'Q1', 'Q2', 'Q3', 'Q4')

sort_by
enum<string>
default:date_desc

Sort order: 'date_desc' (newest first, default when no query), 'relevance' (by semantic relevance, recommended when query is provided), 'date_asc' (oldest first)

Available options:
relevance,
date_desc,
date_asc

Response

Successful Response

Response model for all search tools

docs
SearchToolsDoc · object[]

Search result documents

total_count
integer
default:0

Total number of matching documents

took_ms
integer
default:0

Search execution time in milliseconds