Skip to main content
POST
/
v2
/
search
/
conference-calls
Conference Calls Search
curl --request POST \
  --url https://api.reportify.cn/v2/search/conference-calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbols": [
    "<string>"
  ],
  "query": "<string>",
  "num": 10,
  "start_datetime": "<string>",
  "end_datetime": "<string>",
  "fiscal_year": "<string>",
  "fiscal_quarter": "<string>",
  "sort_by": "date_desc"
}
'
{
  "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/conference-calls
方法: POST
描述: Search for earnings-related conference call transcripts and presentation slides. Query is optional - if not provided, returns documents in reverse chronological order; if provided, sorts by relevance (note sort_by parameter).

​
请求参数

参数名类型必填描述
querystr否搜索关键词（可选）。不提供时按时间倒序返回文档列表；提供时默认按相关性排序。
symbolsarray[str]是股票代码列表，格式为 market:ticker（如 US:AAPL、HK:00700、SH:600519、SZ:000001）。
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。
fiscal_yearstr否财年筛选，如 2025、2026。
fiscal_quarterstr否财季筛选，如 Q1、Q2、Q3、Q4。
sort_bystr否排序方式：date_desc（时间倒序，无 query 时默认）、relevance（相关性排序，有 query 时推荐）、date_asc（时间正序）。默认 date_desc。

​
响应参数

参数名类型描述
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/conference-calls \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "query": "AI strategy",
    "symbols": ["US:AAPL", "US:MSFT"],
    "num": 10,
    "start_datetime": "2024-01-01",
    "end_datetime": "2024-12-31"
}'
Python 示例 
import requests

url = "https://api.reportify.cn/v2/search/conference-calls"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
payload = {
    "query": "AI strategy",
    "symbols": ["US:AAPL", "US:MSFT"],
    "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": "1046915273103380480",
      "title": "Apple Inc. Q4 2024 Earnings Call Transcript",
      "summary": "### 会议要点\n- CEO Tim Cook 讨论了公司在 AI 领域的战略布局\n- CFO 介绍了本季度营收增长情况\n...",
      "category": "transcripts",
      "published_at": 1730390400000,
      "companies": [
        {
          "name": "Apple Inc.",
          "stocks": [
            {
              "code": "AAPL",
              "market": "US",
              "symbol": "US:AAPL"
            }
          ]
        }
      ],
      "metadata": {
        "report_type": 4,
        "report_status": 2,
        "report_scope": 1,
        "report_language": "en"
      },
      "score": 0.9856,
      "url": "https://reportify.cn/transcripts/1046915273103380480"
    }
  ],
  "total_count": 1,
  "took_ms": 98
}

​
错误响应

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

Authorizations

​
Authorization
string
header
required

Enter your Bearer token

Body

application/json

Request model for earnings-related conference call transcripts and presentation slides search. Query is optional - if not provided, returns documents sorted by date desc.

​
symbols
string[]
required

Stock symbols in market:ticker format (e.g., US:AAPL, HK:00700, SH:600519, SZ:000001)

​
query
string

Search query (optional). If not provided, returns documents sorted by date descending; if provided, results are sorted by relevance by default.

​
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

​
fiscal_year
string

Fiscal year filter (e.g., '2025', '2026')

​
fiscal_quarter
string

Fiscal quarter filter (e.g., 'Q1', 'Q2', 'Q3', 'Q4')

​
sort_by
enum<string>
default:date_desc

Sort order: 'date_desc' (newest first, default when no query), 'relevance' (by semantic relevance, recommended when query is provided), 'date_asc' (oldest first)

Available options:
relevance,
date_desc,
date_asc

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