> ## Documentation Index > Fetch the complete documentation index at: https://docs.reportify.cn/llms.txt > Use this file to discover all available pages before exploring further. # Company Overview > Comprehensive search of company information, covering fundamental details, business overview, executive profiles and more ## 公司概览 **URL**: `/v1/stock/company-overview` **方法**: `POST`\ **描述**: 获取公司综合信息，包括基本面和业务概览。 ### 请求参数 | 参数名 | 类型 | 必填 | 描述 | | ------- | --- | -- | ------------------------------ | | symbols | str | 否 | 股票代码，支持多个，用逗号分隔，如 `00700,AAPL` | | names | str | 否 | 股票名称，支持多个，用逗号分隔，如 `腾讯,苹果` | `symbols` 和 `names` 至少需要提供一个参数。 ### 响应参数 | 参数名 | 类型 | 描述 | | ------------------------------ | ------ | ------------------- | | status | int | HTTP 状态码。 | | code | int | 响应代码（0 表示成功）。 | | message | str | 响应消息。 | | data | object | 公司信息数据。 | |   country | str | 注册国家/地区代码。 | |   nature\_of\_company | str | 公司性质。 | |   fiscal\_year\_end | str | 财年结束日期（MM-DD）。 | |   city | str | 所在城市。 | |   stockList | array | 股票列表信息。 | |     stock\_full\_name | str | 股票全称。 | |     market | str | 市场代码。 | |     symbol | str | 股票代码。 | |     stock\_english\_name | str | 股票英文名称。 | |     industry\_HS\_1 | str | 行业分类一级。 | |     industry\_HS\_2 | str | 行业分类二级。 | |     stock\_name | str | 股票名称。 | |     asset\_class | str | 资产类别。 | |     stock\_english\_full\_name | str | 股票英文全称。 | |     exchange | str | 交易所代码。 | |     industry\_HS\_3 | str | 行业分类三级。 | |     ipo\_date | str | IPO 日期（YYYY-MM-DD）。 | |   company\_english\_full\_name | str | 公司英文全称。 | |   province | str | 省份/地区。 | |   fax | str | 传真号码。 | |   email | str | 联系邮箱。 | |   website | str | 公司网站。 | |   address | str | 注册地址。 | |   company\_english\_name | str | 公司英文名称。 | |   telephone | str | 联系电话。 | |   registration\_date | str | 注册日期（YYYY-MM-DD）。 | |   office\_address | str | 办公地址。 | |   board\_secretary | str | 董事会秘书。 | |   company\_name | str | 公司名称。 | |   company\_full\_name | str | 公司全称。 | |   main\_business | str | 主营业务。 | ### 请求示例 **cURL** ```bash theme={null} curl -X POST https://api.reportify.cn/v1/stock/company-overview \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "symbols": "00700,AAPL" }' ``` **Python** ```python theme={null} import requests url = "https://api.reportify.cn/v1/stock/company-overview" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } # 通过股票代码查询 data = {"symbols": "00700,AAPL"} # 或者通过股票名称查询 # data = {"names": "腾讯,苹果"} response = requests.post(url, headers=headers, json=data) print(response.json()) ``` ### 响应示例 ```json theme={null} { "status": 200, "code": 0, "message": "", "data": { "country": "CYM", "nature_of_company": "民营企业", "fiscal_year_end": "12-31", "city": "开曼群岛", "stockList": [ { "stock_full_name": "腾讯控股有限公司", "market": "HK", "symbol": "00700", "stock_english_name": "TENCENT", "industry_HS_1": "资讯科技业", "industry_HS_2": "软件服务", "stock_name": "腾讯控股", "asset_class": "H shares", "stock_english_full_name": "Tencent Holdings Limited", "exchange": "HK", "industry_HS_3": "数码解决方案服务", "ipo_date": "2004-06-16" } ], "company_english_full_name": "Tencent Holdings Limited", "province": "开曼群岛", "fax": "852-25290222", "email": "ir@tencent.com", "website": "www.tencent.com", "address": "Cricket Square Hutchins Drive, P.O.Box 2681 Grand Cayman KY1-1111 Cayman Islands", "company_english_name": "TENCENT", "telephone": "(86-755)86013388 转 87329", "registration_date": "2004-03-26", "office_address": "香港德辅道中166-168号E168大厦4楼A室", "board_secretary": "刘淑仪", "company_name": "腾讯控股", "company_full_name": "腾讯控股有限公司", "main_business": "在中国为用户提供互联网增值服务、移动及电信增值服务、网络广告服务以及电子商务交易服务。" } } ``` ### 错误响应 | 状态码 | 描述 | | --- | --------- | | 422 | 请求参数验证失败。 | ## OpenAPI ````yaml POST /v1/stock/company-overview openapi: 3.1.0 info: title: Reportify API version: 1.0.0 description: API documentation for Reportify's document management and search services. servers: - url: https://api.reportify.cn description: Production server security: - BearerAuth: [] paths: /v1/stock/company-overview: post: tags: - openapi-v2-stock summary: Company Overview description: >- Comprehensive search of company information, covering fundamental details, business overview, executive profiles and more operationId: company_overview_reportify_api_v2_stock_company_overview_post requestBody: content: application/json: schema: $ref: '#/components/schemas/CompanyOverviewInput' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StockAPIResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] components: schemas: CompanyOverviewInput: properties: symbols: type: string title: Symbols description: >- The symbol of the stock. You can enter multiple items, separated by commas(,) example: HK:00700,US:AAPL names: type: string title: Names description: >- The name of the stock. You can enter multiple items, separated by commas(,) example: 腾讯,苹果 type: object title: CompanyOverviewInput description: Input schema for company overview StockAPIResponse: properties: status: type: integer title: Status description: HTTP status code code: type: integer title: Code description: Response code (0 for success) message: type: string title: Message description: Response message data: type: object title: Data description: Response data (structure varies by endpoint) type: object title: StockAPIResponse description: Generic response wrapper from stock API HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: Enter your Bearer token ````