curl --request POST \
--url https://api.reportify.cn/v2/search/reports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"num": 10,
"categories": [
"reports",
"global_research"
],
"symbols": [
"<string>"
],
"industries": [
"<string>"
],
"channel_ids": [
"<string>"
],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
'import requests
url = "https://api.reportify.cn/v2/search/reports"
payload = {
"query": "<string>",
"num": 10,
"categories": ["reports", "global_research"],
"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,
categories: ['reports', 'global_research'],
symbols: ['<string>'],
industries: ['<string>'],
channel_ids: ['<string>'],
start_datetime: '<string>',
end_datetime: '<string>'
})
};
fetch('https://api.reportify.cn/v2/search/reports', 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/reports",
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,
'categories' => [
'reports',
'global_research'
],
'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/reports"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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/reports")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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/reports")
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 \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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>"
}
]
}Reports Search
Institutional research reports search, covering company research, industry research, macroeconomic analysis, strategy reports and more
curl --request POST \
--url https://api.reportify.cn/v2/search/reports \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "<string>",
"num": 10,
"categories": [
"reports",
"global_research"
],
"symbols": [
"<string>"
],
"industries": [
"<string>"
],
"channel_ids": [
"<string>"
],
"start_datetime": "<string>",
"end_datetime": "<string>"
}
'import requests
url = "https://api.reportify.cn/v2/search/reports"
payload = {
"query": "<string>",
"num": 10,
"categories": ["reports", "global_research"],
"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,
categories: ['reports', 'global_research'],
symbols: ['<string>'],
industries: ['<string>'],
channel_ids: ['<string>'],
start_datetime: '<string>',
end_datetime: '<string>'
})
};
fetch('https://api.reportify.cn/v2/search/reports', 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/reports",
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,
'categories' => [
'reports',
'global_research'
],
'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/reports"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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/reports")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"num\": 10,\n \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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/reports")
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 \"categories\": [\n \"reports\",\n \"global_research\"\n ],\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/reports方法:
POST描述: 搜索来自各机构的研究报告。
请求参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| query | str | 是 | 搜索关键词。 |
| categories | array[str] | 否 | 研报类别,可选值 reports(国内研报)与 global_research(外资研报),默认两者全选,可单独指定其一以缩小范围。 |
| 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 | 搜索执行时间(毫秒)。 |
请求示例
cURLcurl -X POST https://api.reportify.cn/v2/search/reports \
-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/reports"
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": "1046915273103380483",
"title": "NVIDIA: AI 芯片市场领导者深度分析",
"summary": "### 报告要点\n- NVIDIA 在 AI 芯片市场占据主导地位\n- 数据中心业务持续高速增长\n...",
"category": "reports",
"published_at": 1730390400000,
"companies": [
{
"name": "NVIDIA Corporation",
"stocks": [
{
"code": "NVDA",
"market": "US",
"symbol": "US:NVDA"
}
]
}
],
"metadata": {
"report_type": 4,
"report_status": 2,
"report_scope": 1,
"report_language": "en"
},
"score": 0.9812,
"url": "https://reportify.cn/reports/1046915273103380483"
}
],
"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": 112
}
错误响应
| HTTP 状态码 | 描述 |
|---|---|
| 422 | 请求参数验证错误 |
Authorizations
Enter your Bearer token
Body
Request model for reports search
Search query
Number of results to return
1 <= x <= 100Report categories to search: 'reports' (domestic research reports) and/or 'global_research' (foreign/overseas research reports). Defaults to both; specify a subset to narrow the search.
Categories available for the reports search endpoint
reports, global_research Stock 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
