Skip to main content

​
search.all()

搜索所有类型的文档。 
docs = client.search.all(
    query="Tesla earnings",
    num=10,
    categories=["news", "reports"],
    symbols=["US:TSLA"],
    start_datetime="2024-01-01",
    end_datetime="2024-12-31"
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量，最大 100
​
categories
list[str]
文档类别过滤，可选值：news, reports, filings, transcripts, socials
​
symbols
list[str]
股票代码列表，格式为 market:ticker（如 US:AAPL、HK:00700、SH:600519、SZ:000001）
​
industries
list[str]
行业过滤
​
channel_ids
list[str]
渠道 ID 过滤
​
start_datetime
str
开始时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
end_datetime
str
结束时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
返回值
list[dict]
文档列表，每个文档包含 title, summary, category, published_at 等字段

​
search.news()

搜索新闻文章。 
news = client.search.news(
    query="Apple iPhone",
    num=10,
    symbols=["US:AAPL"]
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量
​
symbols
list[str]
股票代码过滤
​
channel_ids
list[str]
渠道 ID 过滤
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
search.reports()

搜索研究报告。 
reports = client.search.reports(
    query="semiconductor analysis",
    num=10
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量
​
symbols
list[str]
股票代码过滤
​
industries
list[str]
行业过滤
​
channel_ids
list[str]
渠道 ID 过滤
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
search.filings()

搜索公司公告和财报。 
filings = client.search.filings(
    query="10-K annual report",
    symbols=["US:AAPL"]
)
​
query
string
required
搜索关键词
​
symbols
list[str]
required
股票代码列表（必填）
​
num
int
default:"10"
返回结果数量
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
search.conference_calls()

Search for earnings-related conference call transcripts and presentation slides. Query is optional - if not provided, returns documents in reverse chronological order; if provided, sorts by relevance (note sort_by parameter). 
# With query - results sorted by relevance
calls = client.search.conference_calls(
    ["US:AAPL", "US:MSFT"],
    query="AI strategy",
    fiscal_year="2025",
    fiscal_quarter="Q4"
)

# Without query - results sorted by date descending
calls = client.search.conference_calls(
    ["US:AAPL", "US:MSFT"],
    fiscal_year="2025"
)
​
query
string
搜索关键词（可选）。不提供时按时间倒序返回文档列表；提供时默认按相关性排序。
​
symbols
list[str]
required
股票代码列表（必填）
​
num
int
default:"10"
返回结果数量
​
start_datetime
str
开始时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
end_datetime
str
结束时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
fiscal_year
str
财年筛选，如 2025、2026
​
fiscal_quarter
str
财季筛选，如 Q1、Q2、Q3、Q4
​
sort_by
str
default:"date_desc"
排序方式：date_desc（时间倒序，无 query 时默认）、relevance（相关性排序，有 query 时推荐）、date_asc（时间正序）

​
search.earnings_pack()

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). 
# With query - results sorted by relevance
docs = client.search.earnings_pack(
    ["US:AAPL", "US:TSLA"],
    query="revenue growth",
    fiscal_year="2025",
    fiscal_quarter="Q4"
)

# Without query - results sorted by date descending
docs = client.search.earnings_pack(
    ["US:AAPL", "US:TSLA"],
    fiscal_year="2025"
)
​
query
string
搜索关键词（可选）。不提供时按时间倒序返回文档列表；提供时默认按相关性排序。
​
symbols
list[str]
required
股票代码列表（必填）
​
num
int
default:"10"
返回结果数量
​
start_datetime
str
开始时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
end_datetime
str
结束时间，格式：YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS
​
fiscal_year
str
财年筛选，如 2025、2026
​
fiscal_quarter
str
财季筛选，如 Q1、Q2、Q3、Q4
​
sort_by
str
default:"date_desc"
排序方式：date_desc（时间倒序，无 query 时默认）、relevance（相关性排序，有 query 时推荐）、date_asc（时间正序）

​
search.minutes()

搜索电话会议和投资者关系（IR）会议。 
minutes = client.search.minutes(
    query="board meeting",
    symbols=["US:AAPL"]
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量
​
symbols
list[str]
股票代码过滤
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
search.socials()

搜索社交媒体内容。 
socials = client.search.socials(
    query="Tesla stock",
    symbols=["US:TSLA"]
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量
​
symbols
list[str]
股票代码过滤
​
channel_ids
list[str]
渠道 ID 过滤
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
search.webpages()

搜索网页内容。 
pages = client.search.webpages(
    query="AI technology",
    num=20
)
​
query
string
required
搜索关键词
​
num
int
default:"10"
返回结果数量
​
start_datetime
str
开始时间
​
end_datetime
str
结束时间

​
返回数据结构

{
    "doc_id": "abc123",
    "title": "Tesla Q4 2024 Earnings Call",
    "summary": "Tesla reported record deliveries...",
    "category": "transcripts",
    "published_at": 1704067200000,  # 毫秒时间戳
    "channel_name": "Tesla Inc.",
    "companies": [
        {
            "name": "Tesla",
            "stocks": [{"symbol": "US:TSLA", "market": "US", "ticker": "TSLA"}]
        }
    ],
    "url": "https://..."
}