Skip to main content
POST
/
v2
/
search
/
news
News Search
curl --request POST \
  --url https://api.reportify.cn/v2/search/news \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "num": 10,
  "symbols": [
    "<string>"
  ],
  "channel_ids": [
    "<string>"
  ],
  "start_datetime": "<string>",
  "end_datetime": "<string>"
}
'
{
  "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
    }
  ],
  "total_count": 0,
  "took_ms": 0
}

​
新闻搜索

URL: /v2/search/news
方法: POST
描述: 搜索新闻文章和市场动态。

​
请求参数

参数名类型必填描述
querystr是搜索关键词。
symbolsarray[str]否股票代码列表，如 ["US:AAPL", "SH:600519"]。
channel_idsarray[str]否频道 ID 列表，用于筛选特定来源的新闻。
numint否返回的结果数量，默认值为 10，最大值为 100。
start_datetimestr否开始时间，格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS。
end_datetimestr否结束时间，格式为 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS。

​
响应参数

参数名类型描述
docsarray搜索结果文档数组，每个文档包含以下字段：
  doc_idstr文档唯一 ID。
  titlestr文档标题。
  summarystr文档摘要。
  categorystr文档类别。
  published_atint发布时间（毫秒级时间戳）。
  companiesarray相关公司列表。
  metadataobject文档元数据。
  scorenumber相关性评分。
  urlstr文档链接。
total_countint匹配文档总数。
took_msint搜索执行时间（毫秒）。

​
请求示例

cURL 
curl -X POST https://api.reportify.cn/v2/search/news \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "query": "芯片出口管制",
    "symbols": ["US:NVDA", "US:AMD"],
    "num": 10,
    "start_datetime": "2024-01-01",
    "end_datetime": "2024-12-31"
}'
Python 示例 
import requests

url = "https://api.reportify.cn/v2/search/news"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
payload = {
    "query": "芯片出口管制",
    "symbols": ["US:NVDA", "US:AMD"],
    "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": "1046915273103380485",
      "title": "美国加强对华芯片出口管制，NVIDIA 股价承压",
      "summary": "### 新闻要点\n- 美国商务部宣布新一轮芯片出口管制措施\n- NVIDIA 等芯片公司股价受到影响\n...",
      "category": "news",
      "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": "zh"
      },
      "score": 0.9634,
      "url": "https://reportify.cn/news/1046915273103380485"
    }
  ],
  "total_count": 1,
  "took_ms": 78
}

​
错误响应

HTTP 状态码描述
422请求参数验证错误

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request model for news search

​
query
string
required

Search query

​
num
integer
default:10

Number of results to return

Required range: 1 <= x <= 100
​
symbols
string[]

Stock symbols to filter by

​
channel_ids
string[]

Channel IDs to filter by

​
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

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