Search
curl --request POST \
--url https://api.reportify.cn/v2/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"num": 10,
"symbols": [
"<string>"
],
"industries": [
"<string>"
],
"channel_ids": [
"<string>"
],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
'import requests
url = "https://api.reportify.cn/v2/search"
payload = {
"query": "<string>",
"num": 10,
"symbols": ["<string>"],
"industries": ["<string>"],
"channel_ids": ["<string>"],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
num: 10,
symbols: ['<string>'],
industries: ['<string>'],
channel_ids: ['<string>'],
start_datetime: '<string>',
end_datetime: '<string>'
})
};
fetch('https://api.reportify.cn/v2/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reportify.cn/v2/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'num' => 10,
'symbols' => [
'<string>'
],
'industries' => [
'<string>'
],
'channel_ids' => [
'<string>'
],
'start_datetime' => '<string>',
'end_datetime' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reportify.cn/v2/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reportify.cn/v2/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reportify.cn/v2/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"docs": [
{
"doc_id": "<string>",
"title": "<string>",
"url": "<string>",
"summary": "<string>",
"category": "<string>",
"published_at": 123,
"companies": [
{
"name": "<string>",
"logo": "<string>",
"stocks": [
{
"symbol": "<string>",
"market": "<string>",
"code": "<string>"
}
]
}
],
"metadata": {},
"score": 123
}
],
"chunks": [],
"total_count": 0,
"took_ms": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}v2
Search
Comprehensive search of financial and investment documents, covering various types
POST
/
v2
/
search
Search
curl --request POST \
--url https://api.reportify.cn/v2/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"num": 10,
"symbols": [
"<string>"
],
"industries": [
"<string>"
],
"channel_ids": [
"<string>"
],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
'import requests
url = "https://api.reportify.cn/v2/search"
payload = {
"query": "<string>",
"num": 10,
"symbols": ["<string>"],
"industries": ["<string>"],
"channel_ids": ["<string>"],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: '<string>',
num: 10,
symbols: ['<string>'],
industries: ['<string>'],
channel_ids: ['<string>'],
start_datetime: '<string>',
end_datetime: '<string>'
})
};
fetch('https://api.reportify.cn/v2/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reportify.cn/v2/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'query' => '<string>',
'num' => 10,
'symbols' => [
'<string>'
],
'industries' => [
'<string>'
],
'channel_ids' => [
'<string>'
],
'start_datetime' => '<string>',
'end_datetime' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.reportify.cn/v2/search"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.reportify.cn/v2/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reportify.cn/v2/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"query\": \"<string>\",\n \"num\": 10,\n \"symbols\": [\n \"<string>\"\n ],\n \"industries\": [\n \"<string>\"\n ],\n \"channel_ids\": [\n \"<string>\"\n ],\n \"start_datetime\": \"<string>\",\n \"end_datetime\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"docs": [
{
"doc_id": "<string>",
"title": "<string>",
"url": "<string>",
"summary": "<string>",
"category": "<string>",
"published_at": 123,
"companies": [
{
"name": "<string>",
"logo": "<string>",
"stocks": [
{
"symbol": "<string>",
"market": "<string>",
"code": "<string>"
}
]
}
],
"metadata": {},
"score": 123
}
],
"chunks": [],
"total_count": 0,
"took_ms": 0
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}通用文档搜索
URL:/v2/search方法:
POST描述: 跨所有文档类别的通用搜索接口,支持搜索财报、电话会议、研究报告、公告、新闻、社交媒体等多种类型的文档。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| query | str | 是 | 搜索关键词。 |
| symbols | array[str] | 否 | 股票代码列表,格式为 market:ticker(如 US:AAPL、HK:00700、SH:600519、SZ:000001)。 |
| industries | array[str] | 否 | 行业列表,如 ["科技", "消费"]。 |
| channel_ids | array[str] | 否 | 频道 ID 列表,用于筛选特定来源。 |
| num | int | 否 | 返回的结果数量,默认值为 10,最大值为 100。 |
| start_datetime | str | 否 | 开始时间,格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS。 |
| end_datetime | str | 否 | 结束时间,格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS。 |
响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| docs | array | 搜索结果文档数组,每个文档包含以下字段: |
| doc_id | str | 文档唯一 ID。 |
| title | str | 文档标题。 |
| summary | str | 文档摘要。 |
| category | str | 文档类别。 |
| published_at | int | 发布时间(毫秒级时间戳)。 |
| companies | array | 相关公司列表。 |
| metadata | object | 文档元数据。 |
| score | number | 相关性评分。 |
| url | str | 文档链接。 |
| chunks | array | 内容分片数组,用于原文引用;news、webpages 搜索不返回该字段。每个分片包含以下字段: |
| id | str | 分片唯一 ID。 |
| type | str | 分片类型。 |
| content | str | 分片正文内容。 |
| summary | str | 分片摘要,可能为 null。 |
| score | number | 分片相关性评分。 |
| metadata | object | 分片元数据。 |
| doc | object | 分片所属文档:包含 doc_id、title、url、published_at 等。 |
| total_count | int | 匹配文档总数。 |
| took_ms | int | 搜索执行时间(毫秒)。 |
支持的文档类型
financials: 财务报告transcripts: 电话会议记录reports: 研究报告filings: 公司公告news: 新闻文章socials: 社交媒体内容
请求示例
cURLcurl -X POST https://api.reportify.cn/v2/search \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
"query": "人工智能 业绩增长",
"symbols": ["US:NVDA", "US:MSFT"],
"industries": ["科技"],
"num": 10,
"start_datetime": "2024-01-01",
"end_datetime": "2024-12-31"
}'
import requests
url = "https://api.reportify.cn/v2/search"
headers = {
"Authorization": "Bearer 447460****09c9",
"Content-Type": "application/json"
}
payload = {
"query": "人工智能 业绩增长",
"symbols": ["US:NVDA", "US:MSFT"],
"industries": ["科技"],
"num": 10,
"start_datetime": "2024-01-01",
"end_datetime": "2024-12-31"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
响应示例
{
"docs": [
{
"doc_id": "1046915273103380488",
"title": "腾讯控股 2024年Q3 业绩电话会议记录",
"summary": "### 要点\n- 游戏业务收入同比增长 12%\n- 广告业务持续强劲增长\n...",
"category": "transcripts",
"published_at": 1679486400000,
"companies": [
{
"name": "腾讯控股",
"stocks": [
{
"code": "00700",
"market": "HK",
"symbol": "HK:00700"
},
{
"code": "TCEHY",
"market": "US",
"symbol": "US:TCEHY"
}
]
}
],
"metadata": {
"report_type": 4,
"report_status": 2,
"report_scope": 1,
"report_language": "zh"
},
"score": 0.9876,
"url": "https://reportify.cn/transcripts/1046915273103380488"
}
],
"chunks": [
{
"id": "624813519365412",
"type": "text",
"content": "……匹配到的原文分片内容……",
"summary": null,
"score": 0.87,
"metadata": {},
"doc": {
"doc_id": "1046915273103380483",
"title": "示例文档标题",
"url": "https://reportify.cn/reports/1046915273103380483",
"published_at": 1730390400000
}
}
],
"total_count": 1,
"took_ms": 98
}
错误响应
| HTTP 状态码 | 描述 |
|---|---|
| 422 | 请求参数验证错误 |
Authorizations
Enter your Bearer token
Body
application/json
Request model for general document search
Search query
Number of results to return
Required range:
1 <= x <= 100Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)
Industries to filter by
Channel IDs to filter by
Start datetime in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format
End datetime in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format
Response
Successful Response
Response model for all search tools
Search result documents
Show child attributes
Show child attributes
Search result content chunks (parity with the internal search tools). Empty for news and webpages searches.
Total number of matching documents
Search execution time in milliseconds
