---
title: "批量公司简况（多只一次取）"
method: GET
path: "/v1/profile-batch"
tags: ["pro"]
---

# 批量公司简况（多只一次取）

`GET /v1/profile-batch`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/profile-batch`
- Auth: none declared

⭐ **一次拿多只公司的简况**（上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 联系方式），**逐只标明成功与否** —— 给量化选股后的批量画像、行业归类用。

**它解决什么**：`/v1/profile` 一次只能问一只，筛出 100 只后要循环 100 次；本端点实测 **100 只 6.8 秒**拿完，且**缺了哪只一眼可见**。

**用法**：`codes` 用**逗号分隔**，如 `?codes=sh600519,sz000001,sz300750`；支持裸 6 位码（`600519`）与带前缀（`sh600519`）。

**返回**：`data` 是数组，每项 `{code, ok, data}`（或 `error`）—— **取几只就回几个条目**；同时给 `requested` / `returned` / `failed` 计数。

⚠️ **与 `/v1/profile` 的区别**：`/v1/profile` 的 `code` 虽也支持逗号，但返回是**扁平行、没有逐只状态**，无效代码会被**静默丢弃**（少了哪只你算不出来）；本端点**逐只回填**，缺谁、为什么缺都写清楚。

**上限**：专业版单次最多 **100** 只，不限量版 **150** 只。**计费按实际返回只数**（失败的不计）。

⚠️ **仅 A 股**（`sh`/`sz`/`bj`，含指数与 ETF）—— 港股/美股/板块在批量里不稳定，传了会标 `ok:false` 并提示改用 `/v1/profile` 单只查询（⛔ 不返回错数据）。

⚠️ 指数与 ETF 的 `industry` / `listedDate` 可能是 `-`（上游没有该字段），不代表取数失败。

⚠️ **付费端点**：**专业版（¥99）及以上**，标准版不可用。

## Query parameters

- `codes` string, required: 多个股票代码，逗号分隔：sh600519,sz000001（专业版 ≤100 只 · 不限量版 ≤150 只）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)