Skip to main content
POST
/
v2
/
search
/
filings
Filings Search
curl --request POST \
  --url https://api.reportify.cn/v2/search/filings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "<string>",
  "symbols": [
    "<string>"
  ],
  "num": 10,
  "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/filings
方法: POST
描述: 搜索公司公告和官方文件。

​
请求参数

参数名类型必填描述
querystr是搜索关键词。
symbolsarray[str]是股票代码列表，如 ["US:AAPL", "SH:600519"]。
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/filings \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "query": "股权激励",
    "symbols": ["SH:600519"],
    "num": 10,
    "start_datetime": "2024-01-01",
    "end_datetime": "2024-12-31"
}'
Python 示例 
import requests

url = "https://api.reportify.cn/v2/search/filings"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
payload = {
    "query": "股权激励",
    "symbols": ["SH:600519"],
    "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": "1046915273103380484",
      "title": "贵州茅台关于实施股权激励计划的公告",
      "summary": "### 公告要点\n- 公司拟实施股权激励计划\n- 激励对象包括核心管理人员和技术骨干\n...",
      "category": "filings",
      "published_at": 1730390400000,
      "companies": [
        {
          "name": "贵州茅台",
          "stocks": [
            {
              "code": "600519",
              "market": "SH",
              "symbol": "SH:600519"
            }
          ]
        }
      ],
      "metadata": {
        "report_type": 4,
        "report_status": 2,
        "report_scope": 1,
        "report_language": "zh"
      },
      "score": 0.9756,
      "url": "https://reportify.cn/filings/1046915273103380484"
    }
  ],
  "total_count": 1,
  "took_ms": 95
}

​
错误响应

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 filings search

​
query
string
required

Search query

​
symbols
string[]
required

Stock symbols to filter by

​
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

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