apipick-company-facts

TotalClaw 作者 totalclaw

使用 apipick Company Facts API 按股票代码或 SEC CIK 编号检索上市公司信息。返回公司名称、行业、部门、交易所、市值、员工人数、网站和 SEC 备案 URL。当用户想要查找公司信息、查找公司的市值或员工人数、获取上市公司的 SEC 备案链接或检索有关任何上市公司的基本事实时使用。需要 apipick API 密钥 (x-api-key)。在 https://www.apipick.com 获取免费密钥。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~javainthinking-apipick-company-facts

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~javainthinking-apipick-company-facts/file -o javainthinking-apipick-company-facts.md

## 概述（中文）

使用 apipick Company Facts API 按股票代码或 SEC CIK 编号检索上市公司信息。返回公司名称、行业、部门、交易所、市值、员工人数、网站和 SEC 备案 URL。当用户想要查找公司信息、查找公司的市值或员工人数、获取上市公司的 SEC 备案链接或检索有关任何上市公司的基本事实时使用。需要 apipick API 密钥 (x-api-key)。在 https://www.apipick.com 获取免费密钥。

## 原文

# apipick Company Facts

Retrieve public company data via stock ticker symbol or SEC CIK number.

## Endpoint

```
GET https://www.apipick.com/api/company/facts
```

**Authentication:** `x-api-key: YOUR_API_KEY` header required.
Get a free API key at https://www.apipick.com/dashboard/api-keys

## Request Parameters

Use **either** `ticker` or `cik` (not both):

| Parameter | Description |
|-----------|-------------|
| `ticker` | Stock ticker symbol (e.g. `AAPL`, `MSFT`, `GOOGL`, `TSLA`) |
| `cik` | SEC Central Index Key number (e.g. `0000320193`) |

```bash
# By ticker
GET /api/company/facts?ticker=AAPL

# By CIK
GET /api/company/facts?cik=0000320193
```

## Response

```json
{
  "company_facts": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "industry": "Technology",
    "sector": "Consumer Electronics",
    "exchange": "NASDAQ",
    "market_cap": 3000000000000,
    "number_of_employees": 164000,
    "website_url": "https://www.apple.com",
    "sec_filings_url": "https://www.sec.gov/edgar/browse/?CIK=320193"
  }
}
```

## Error Codes

| Code | Meaning |
|------|---------|
| 400 | Invalid or missing ticker/CIK parameter |
| 401 | Missing or invalid API key |
| 402 | Insufficient credits |

**Cost:** 1 credit per request

## Usage Pattern

1. Use `$APIPICK_API_KEY` env var as the `x-api-key` header value; if not set, ask the user for their apipick API key
2. Accept a company name, ticker, or CIK from the user
3. If the user provides a company name, infer the ticker (e.g. "Apple" → `AAPL`, "Microsoft" → `MSFT`)
4. Make the GET request with `ticker` or `cik`
5. Present results clearly; format `market_cap` as a readable figure (e.g. `$3T`, `$250B`)

See [references/api_reference.md](references/api_reference.md) for full response field descriptions.