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

​
根据标签获取文档

URL: /v1/docs/tags
方法: POST
描述: 根据指定标签（tag）获取相关文档。

​
请求参数

参数名类型描述
tagsarray标签数组，例如 ["AI", "Chips"]。
languagestr搜索语言，支持值为 all，chinese，english。暂未支持
categoriesarray文档类别（默认不包含 files），可选值有 filings，transcripts，reports，news，files。
start_datestr开始日期，格式为 YYYY-MM-DD。
end_datestr结束日期，格式为 YYYY-MM-DD。
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/docs/tags" \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{"tags": ["AI", "Chips"], 
"language": "english", 
"categories": ["filings", "transcripts"], 
"start_date": "2024-01-01", 
"end_date": "2024-12-31", 
"page": 1, 
"page_num": 10}'

Python 示例

import requests

url = "https://api.reportify.cn/v1/docs/tags"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
data = {  
    "tags": ["AI", "Chips"],
    "language": "english",
    "categories": ["filings", "transcripts"],
    "start_date": "2024-01-01",
    "end_date": "2024-12-31",
    "page": 1,
    "page_num": 10
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

​
响应示例

{
  "page": 1,
  "page_num": 10,
  "total_page": 5,
  "total_num": 50,
  "docs": [
    {
      "id": "1046895208953942016",
      "title": "Apple 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": "AAPL",
      "company_name": "Apple Inc.",
      "logo": "https://files.reportify.cn/logo/AAPL.svg",
      "summary": "This report covers Apple's earnings in Q4 2023...",
      "tags": {
        "key": "industry",
        "value": ["AI", "Chips"]
      },
      "metadatas": {
        "key": "period",
        "value": ["Q4 2023"]
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
tags
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
​
start_date
string
​
end_date
string

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[]