POST
/
v1
/
search
curl --request POST \
  --url https://api.reportify.cn/v1/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "page_num": 1,
  "page_size": 10,
  "query": "<string>",
  "categories": [
    "filings"
  ],
  "markets": [
    "cn"
  ],
  "institutions": [],
  "symbols": [],
  "tags": [],
  "start_date": "<string>",
  "end_date": "<string>",
  "mode": "smart",
  "sort": "smart"
}'
{
  "total_count": 0,
  "total_page": 0,
  "page_num": 1,
  "page_size": 10,
  "docs": []
}

​
文档搜索

URL: /v1/search
方法: POST
描述: 根据指定条件搜索文档

​
请求参数

参数名类型描述
querystr搜索关键词。
languagestr搜索语言，支持值为 all，chinese，english。暂未支持
categoriesarray文档类别（默认不包含 files），可选值有 filings，transcripts，reports，news，files。
marketsarray市场区域，默认包括所有市场。可选值有 cn，hk，us。
institutionsarray指定机构筛选，如 Morgan Stanley，财联社。
symbolsarray股票代码筛选，如 000001，00700，AAPL。
tagsarray文档标签，如 AI，Chips。
start_datestr开始日期，格式为 YYYY-MM-DD。
end_datestr结束日期，格式为 YYYY-MM-DD。
modestr搜索模式，支持 smart，semantic，keywords。
sortstr排序方式，支持 smart，latest。
pageint当前页码，默认值为 1。
page_numint每页显示的条目数，默认值为 10。

​
响应参数

参数名类型描述
pageint当前页码。
page_numint每页条目数。
total_pageint总页数。
total_numint总条目数。
docsarray文档数组，每个文档包含以下字段：
  idstr文档唯一 ID。
  titlestr文档标题。
  urlstr文档网页链接。
  file_urlstr文档文件链接。
  media_urlstr媒体文件链接（如有）。
  institutionstr发布机构。
  authorstr作者。
  published_atstr发布时间，格式为 YYYY-MM-DDTHH:MM:SS.000Z。
  categorystr文档类别（filings, transcripts, reports, news, files）。
  marketstr市场区域（cn, hk, us）。
  symbolstr股票代码。
  company_namestr公司名称。
  logostr公司 Logo 链接。
  summarystr文档摘要。暂未支持
  tagsdict标签数组。
    keystr标签类型（如 industry, company, person, event）。
    valuearray标签内容数组。
  metadatasdict元数据数组，包含以下字段：
    keystr元数据类型（如 period, entities）。
    valuearray元数据内容数组。

​
请求示例

cURL

curl -X POST https://api.reportify.cn/v1/search \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "query": "Tesla",
    "language": "english",
    "categories": ["filings", "reports"],
    "markets": ["us"],
    "institutions": ["Morgan Stanley"],
    "symbols": ["TSLA"],
    "tags": ["AI"],
    "start_date": "2023-12-01",
    "end_date": "2023-12-31",
    "mode": "smart",
    "sort": "latest",
    "page": 1,
    "page_num": 10
}'

Python

import requests

url = "https://api.reportify.cn/v1/search"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
payload = {
    "query": "Tesla",
    "language": "english",
    "categories": ["filings", "reports"],
    "markets": ["us"],
    "institutions": ["Morgan Stanley"],
    "symbols": ["TSLA"],
    "tags": ["AI"],
    "start_date": "2023-12-01",
    "end_date": "2023-12-31",
    "mode": "smart",
    "sort": "latest",
    "page": 1,
    "page_num": 10
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

​
响应示例

{
  "page": 1,
  "page_num": 10,
  "total_page": 5,
  "total_num": 50,
  "docs": [
    {
      "id": "1046895208953942016",
      "title": "Tesla Q4 Earnings Report",
      "url": "https://reportify.cn/filings/1046895208953942016",
      "file_url": "https://files.reportify.cn/media/production/TSLA5a08ddfbb97bd6486fff7a3875e7fe28_20241024183012.pdf",
      "media_url": "https://files.reportify.cn/media/production/s_4728833_9e25b61b62960211e6040eb2b81b352c.mp3",
      "institution": "Morgan Stanley",
      "author": "Jane Doe",
      "published_at": "2023-12-31T00:00:00.000Z",
      "category": "reports",
      "type": "research_report_company",
      "market": "us",
      "symbol": "TSLA",
      "company_name": "Tesla Inc.",
      "logo": "https://files.reportify.cn/logo/TSLA.svg",
      "summary": "This report covers Tesla's earnings in Q4...",
      "tags": {
        "industry": [
          "AI",
          "EV"
        ],
        "company": [
          "Tesla"
        ]
      },
      "metadatas": {
        "period": "Q4 2023",
        "entities": [
          "Tesla Inc.",
          "TSLA"
        ]
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
query
string
required
​
page_num
integer
default:1
​
page_size
integer
default:10
​
categories
enum<string>[]

An enumeration.

Available options:
filings,
transcripts,
reports,
news,
files
​
markets
enum<string>[]

An enumeration.

Available options:
cn,
hk,
us
​
institutions
string[]
​
symbols
string[]
​
tags
string[]
​
start_date
string
​
end_date
string
​
mode
enum<string>
default:smart

An enumeration.

Available options:
smart,
semantic,
keywords
​
sort
enum<string>
default:smart

An enumeration.

Available options:
smart,
latest

Response

200
application/json
Successful Response
​
total_count
integer
default:0
​
total_page
integer
default:0
​
page_num
integer
default:1
​
page_size
integer
default:10
​
docs
object[]