> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Batch Enrich Companies > 按用量计费；默认请求预估费用：$0.0093 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/companyenrich/enrich-companies * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/companyenrich/enrich-companies` * **Runtime 事实版本:** 820bb7817c59193621186d0a7e630f3f0f7d277be8c4a30ac65cde11e8c585c7 [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/companyenrich.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "operationId": "companyenrich.enrich-companies", "method": "POST", "path": "/apis/v1/companyenrich/enrich-companies", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expand": { "default": [], "items": { "enum": [ "workforce" ], "type": "string" }, "maxItems": 1, "minItems": 0, "type": "array", "description": "Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: `workforce` (adds the `workforce` field; costs 5 credits per company)." }, "domains": { "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array", "description": "A list of domains to enrich. Up to 50 domains can be provided in a single request.", "examples": [ [ "example.com", "google.com" ] ] } }, "required": [ "domains" ] } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0093, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## 费用与请求规则 按用量计费；默认请求预估费用：\$0.0093 USD（不是固定价格）。 声明的单位费率：每 provider\_credit \$0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。 * **默认请求参考估价（USD）:** 0.0093 * **声明的单位费率（USD）:** 1e-06 * **计费单位:** provider\_credit * **计费依据:** response\_units * **公开参考倍率:** 1.0 * **声明的最大计数或单位数:** 10000000 * **结算证据来源:** response\_body ## OpenAPI ````yaml reference-contracts/zh/companyenrich.json POST /apis/v1/companyenrich/enrich-companies openapi: 3.1.0 info: description: '' title: CompanyEnrich version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/companyenrich/autocomplete-keywords - /apis/v1/companyenrich/autocomplete-positions - /apis/v1/companyenrich/autocomplete-technologies - /apis/v1/companyenrich/companies-enrich - /apis/v1/companyenrich/companies-enrich-batch - /apis/v1/companyenrich/companies-enrich-by-properties - /apis/v1/companyenrich/companies-get - /apis/v1/companyenrich/companies-search - /apis/v1/companyenrich/companies-search-scroll - /apis/v1/companyenrich/companies-similar - /apis/v1/companyenrich/companies-similar-scroll - /apis/v1/companyenrich/companies-workforce - /apis/v1/companyenrich/enrich-by-domain - /apis/v1/companyenrich/enrich-by-properties - /apis/v1/companyenrich/enrich-companies - /apis/v1/companyenrich/find-similar-companies - /apis/v1/companyenrich/get-company-workforce - /apis/v1/companyenrich/get-country-by-code - /apis/v1/companyenrich/get-regions - /apis/v1/companyenrich/list-industries - /apis/v1/companyenrich/lookup-person - /apis/v1/companyenrich/people-get - /apis/v1/companyenrich/people-lookup - /apis/v1/companyenrich/people-search - /apis/v1/companyenrich/people-search-scroll - /apis/v1/companyenrich/scroll-people-search - /apis/v1/companyenrich/search-cities - /apis/v1/companyenrich/search-companies - /apis/v1/companyenrich/search-countries - /apis/v1/companyenrich/search-people - /apis/v1/companyenrich/search-states x-aisa-document: facts_hash: 820bb7817c59193621186d0a7e630f3f0f7d277be8c4a30ac65cde11e8c585c7 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: companyenrich.companies-enrich path: /apis/v1/companyenrich/companies-enrich method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.companies-search-scroll path: /apis/v1/companyenrich/companies-search-scroll method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.companies-similar path: /apis/v1/companyenrich/companies-similar method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.companies-similar-scroll path: /apis/v1/companyenrich/companies-similar-scroll method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.companies-workforce path: /apis/v1/companyenrich/companies-workforce method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.enrich-by-domain path: /apis/v1/companyenrich/enrich-by-domain method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: companyenrich.people-search-scroll path: /apis/v1/companyenrich/people-search-scroll method: POST statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:e5ef2dd948d4b17da0e058752f22ca8fc5828d080ba3400dd493c52d0e7d5dbb x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: companyenrich x-aisa-catalogs: companyenrich: title: CompanyEnrich description: '' x-aisa-document: facts_hash: 820bb7817c59193621186d0a7e630f3f0f7d277be8c4a30ac65cde11e8c585c7 generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/companyenrich/enrich-companies: post: tags: - CompanyEnrich summary: Batch Enrich Companies description: >- 按用量计费；默认请求预估费用：$0.0093 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 operationId: companyenrich.enrich-companies requestBody: required: true content: application/json: schema: type: object properties: expand: default: [] items: enum: - workforce type: string maxItems: 1 minItems: 0 type: array description: >- Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: `workforce` (adds the `workforce` field; costs 5 credits per company). domains: type: array items: type: string examples: - - example.com - google.com maxItems: 50 minItems: 1 description: >- A list of domains to enrich. Up to 50 domains can be provided in a single request. required: - domains responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/companyenrich/enrich-companies \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "domains": [ "example.com", "google.com" ] }' components: schemas: Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__101a599c39e0d058 Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__101a599c39e0d058: type: object required: - companies - total_enriched properties: companies: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__74fd576ca6841cee total_enriched: type: integer Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__74fd576ca6841cee: type: object required: - id properties: id: type: string name: type: string type: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__e305ea5bb33a1f2f domain: type: string revenue: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__1b2fe457a98d9bc8 socials: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__45cfd6c8a777616c website: type: string industry: type: string keywords: type: array items: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__20b6b1d8f0c1ac14 logo_url: type: string employees: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__511cd78cef691d31 financial: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__978d3a76911add6e page_rank: type: number workforce: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__f741bfb3ece1d332 categories: type: array items: anyOf: - type: string - $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__ecddede95117cdd1 industries: type: array items: type: string updated_at: type: string description: type: string naics_codes: type: array items: type: string founded_year: type: integer subsidiaries: type: array items: type: string technologies: type: array items: type: string seo_description: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__e305ea5bb33a1f2f: enum: - unknown - private - public - self-employed - self-owned - partnership - nonprofit - educational - government type: string Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__1b2fe457a98d9bc8: enum: - under-1m - 1m-10m - 10m-50m - 50m-100m - 100m-200m - 200m-1b - over-1b type: string Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__45cfd6c8a777616c: type: object properties: g2_url: type: string github_url: type: string linkedin_id: type: string twitter_url: type: string youtube_url: type: string facebook_url: type: string linkedin_url: type: string angellist_url: type: string instagram_url: type: string crunchbase_url: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__20b6b1d8f0c1ac14: type: object properties: city: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__aa1a2487268e4b73 phone: type: string state: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__aa1a2487268e4b73 address: type: string country: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__aa1a2487268e4b73 postal_code: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__511cd78cef691d31: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1K - 1K-5K - 5K-10K - over-10K type: string Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__978d3a76911add6e: type: object properties: funding: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__f74d075fa7097761 funding_date: type: string stock_symbol: type: string funding_stage: type: string total_funding: type: integer stock_exchange: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__f741bfb3ece1d332: type: object required: - company_id - domain properties: domain: type: string history: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__3eb243dc4fb2f2a6 company_id: type: string department_headcount: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__7dc17c24fd09427f employee_count_range: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__9dc9b56fe5efaeb3 unclassified_headcount: type: integer observed_employee_count: type: integer additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__ecddede95117cdd1: type: object properties: name: type: string score: type: number additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__aa1a2487268e4b73: type: object properties: code: type: string name: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__f74d075fa7097761: type: object properties: date: type: string stage: type: string amount: type: integer investors: type: array items: type: string additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__3eb243dc4fb2f2a6: type: object properties: date: type: string count: type: integer additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__7dc17c24fd09427f: type: object properties: name: type: string count: type: integer additionalProperties: true Response576A0Ea506F3_connect_COMPANYENRICH_ENRICH_COMPANIES__output__9dc9b56fe5efaeb3: type: object properties: range: type: string to_value: type: integer from_value: type: integer additionalProperties: true securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.