US equities

US Main Oper Inc Data

USMainOperIncData

Paid · PlusJSONTry online

This API requires paid access or an active trial. Review its fields and examples first; online payments are not available yet.

Data description

Use the field names shown below when building requests.

【API描述】 1. 接口主要用于获取指定美股上市公司的最新及历史财报披露的主营业务数据； 2. 主营业务构成数据（比如收入，成本，利润，毛利率，营收，营收占比）按照分产品、分行业、分地区（比如境内、境外等）的维度可以查询； 3. 接口收录同一公司在报告期末的四种财务报告数据，即合并未调整报告、母公司未调整报告、合并调整报告以及母公司调整报告； 4. 信息来源：招股说明书、定报、审计报告等【API使用场景】 - 用户需要获取某个或多个美股公司的最新或者历史报告期的主营业务数据，可以深入理解公司的业务范围、核心产品和服务，以及在公司整体业务中的地位和作用。 - 有助于判断公司在市场行业中的定位，包括市场份额、行业排名和竞争优势。 - 有助于评估公司的收入来源、收入结构及其变化趋势；评估开展的具体各项业务的盈利能力，成本控制水平以及未来发展潜力。【注意事项】当用户询问某公司具体产品、业务、行业、地区的收入、成本、利润、毛利率、营收、营收占比等指标时，主营构成api接口比财务报表接口更加适用。

POST /v1/data/operations/USMainOperIncData · JSON

Input parameters

Field	Type	Constraint	Description and example
`stockObject` 股票代码	string_array `string_array`	Required Dictionary selection: `STOCK_COMPANY_US`	股票代码是指美股上市公司通用的股票代码，支持一次获取多个品种数据 Example: `["7006136"]`
`mainOperType` 主营分类方式	string_array `string_array`	Optional Dictionary selection: `MAINOPERTYPE`	主营分类方式是指主营构成的分类方式，分为按行业、按产品、按地区三种分类方式，其中，按产品划分是指按照上市公司经营不同的产品、业务、服务来划分主营业务；按行业划分是指依据公司业务所属的不同行业来划分主营业务；按地区划分是指依据公司业务发生的地域性来划分主营业务 Example: `[…]`
`mainOperFin` 主营财务科目	string_array `string_array`	Optional Dictionary selection: `MAINOPERFIN`	主营财务科目是指财报中披露的主营财务科目，包括主营业务收入 Example: `[…]`
`unit` 主营科目单位	string `string`	Optional Dictionary selection: `AMOUNT_UNIT`	主营科目单位是输出主营财务科目指标的单位，支持元，万元，百万元，亿元，十亿元 Example: `Example text`
`reportDate` 报告期	string_array `string_array`	Optional Dictionary selection: `US_FINANCE_REPORT_TYPE`	报告期类型指主营业务披露所对应的报告期，涵盖半年报与年报，默认限制 Example: `[…]`
`beginDate` 开始日期	string `string`	Optional	根据会计报告期的区间范围查询的开始日期，输入格式“YYYY-MM-DD” Example: `Example text`
`endDate` 截止日期	string `string`	Optional	根据会计报告期的区间范围查询的结束日期，输入格式“YYYY-MM-DD” Example: `Example text`
`pageNo` 页面编号	number `number`	Optional	定位分页查询的目标页码，默认值为1 Example: `1`
`pageSize` 页内记录数	number `number`	Optional	单页返回的最大记录条数，默认为500 Example: `5`

Response fields

Field	Type	Constraint	Description and example
`stockobject` 股票内码	string `string`	—	用于确定证券唯一性的内码。 Example: `Example text`
`stockname` 股票名称	string `string`	—	证券名称是证券市场主体的中文简称。 Example: `Example text`
`stockcode` 股票代码	string `string`	—	证券代码是证券市场主体的交易代码。 Example: `Example text`
`mainopertype` 主营分类方式	string `string`	—	主营分类方式是指主营构成的分类方式，分为按行业、按产品、按地区三种分类方式，其中，按产品划分是指按照上市公司经营不同的产品、业务、服务来划分主营业务；按行业划分是指依据公司业务所属的不同行业来划分主营业务；按地区划分是指依据公司业务发生的地域性来划分主营业务 Example: `Example text`
`mainoperfin` 主营财务科目	string `string`	—	主营财务科目是指财报中披露的主营财务科目，包括主营业务收入 Example: `Example text`
`mainopername` 主营业务名称	string `string`	—	具体的主营业务名称。 Example: `Example text`
`enddate` 报告期	string `string`	—	财务数据所归属的会计期间。 Example: `Example text`
`reportdate` 报告期类型	string `string`	—	报告期类型指主营业务披露所对应的报告期，涵盖半年报与年报 Example: `Example text`
`financevalue` 主营业务财务科目数额	string `string`	—	主营财务科目的具体数值。 Example: `Example text`
`financeunit` 主营业务财务科目单位	string `string`	—	财务数额采用的计量单位。 Example: `Example text`
`currencyunit` 原始币种	string `string`	—	报告披露时采用的计价货币。 Example: `Example text`

Request example

Example instruments, required parameters and applicable page limits are prefilled. Open the side drawer for field notes and a live response.

{
  "parameters": {
    "stockObject": [
      "7006136"
    ],
    "pageNo": 1,
    "pageSize": 5
  }
}

stockObject: 苹果 · AAPL.N
Samples use verified instruments and dictionary values. Records depend on the query range, data updates and the selected key's permissions.
The sample requests 5 records; some business aggregates may return more rows, as shown in the actual response.

Coverage and access boundaries

Run the example to check the securities, dates and fields you need. Available history and content rights vary by endpoint. Requests use your account access and the selected API key.

Follow the parameter notes for minute intervals, price adjustment and time units. A missing field does not mean a zero value.