> ## 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 # Search and Enrich Contacts > 按用量计费；默认请求预估费用：$0.0103 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/lusha/search-and-enrich-contacts * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/lusha/search-and-enrich-contacts` * **Runtime 事实版本:** 4e06df17a40bff0bc4b39c3818736d6c3748778b27890dcc17931d02d4df8b4b [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/lusha.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "operationId": "lusha.search-and-enrich-contacts", "method": "POST", "path": "/apis/v1/lusha/search-and-enrich-contacts", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "contacts" ], "properties": { "reveal": { "type": "array", "items": { "enum": [ "emails", "phones" ], "type": "string" }, "description": "Contact data to reveal: emails, phones, or both." }, "options": { "type": "object", "properties": { "includePartialProfiles": { "type": "boolean", "description": "Whether Lusha may return partial contact profiles." } }, "description": "Additional contact search options.", "additionalProperties": false }, "contacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "A known Lusha contact ID." }, "email": { "type": "string", "description": "The contact's known email address." }, "lastName": { "type": "string", "description": "The contact's last name." }, "firstName": { "type": "string", "description": "The contact's first name." }, "companyName": { "type": "string", "description": "The contact's company name." }, "linkedinUrl": { "type": "string", "description": "The contact's LinkedIn profile URL." }, "companyDomain": { "type": "string", "description": "The contact's company domain." }, "clientReferenceId": { "type": "string", "description": "Caller-defined reference returned with this contact's result." } }, "description": "A documented set of identifiers used to find one Lusha contact.", "additionalProperties": false }, "maxItems": 100, "minItems": 1, "description": "One to 100 contacts identified by Lusha ID, LinkedIn URL, email, or name and company." } }, "additionalProperties": false } } } }, "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.0103, "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.0103 USD（不是固定价格）。 声明的单位费率：每 provider\_credit \$0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。 * **默认请求参考估价（USD）:** 0.0103 * **声明的单位费率（USD）:** 1e-06 * **计费单位:** provider\_credit * **计费依据:** response\_units * **公开参考倍率:** 1.0 * **声明的最大计数或单位数:** 10000000 * **结算证据来源:** response\_body ## OpenAPI ````yaml reference-contracts/zh/lusha.json POST /apis/v1/lusha/search-and-enrich-contacts openapi: 3.1.0 info: description: '' title: Lusha 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/lusha/buying-group - /apis/v1/lusha/companies-enrich - /apis/v1/lusha/companies-enrich-by-id - /apis/v1/lusha/companies-lookalike - /apis/v1/lusha/companies-search - /apis/v1/lusha/companies-signals - /apis/v1/lusha/contacts-lookalike - /apis/v1/lusha/contacts-signals - /apis/v1/lusha/enrich-contacts - /apis/v1/lusha/people-contacts-enrich - /apis/v1/lusha/people-enrich - /apis/v1/lusha/people-phone-find - /apis/v1/lusha/people-search - /apis/v1/lusha/prospect-contacts - /apis/v1/lusha/search-and-enrich-contacts - /apis/v1/lusha/search-contacts x-aisa-document: facts_hash: 4e06df17a40bff0bc4b39c3818736d6c3748778b27890dcc17931d02d4df8b4b generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: lusha.buying-group path: /apis/v1/lusha/buying-group method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.companies-enrich path: /apis/v1/lusha/companies-enrich method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.companies-enrich-by-id path: /apis/v1/lusha/companies-enrich-by-id method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.companies-lookalike path: /apis/v1/lusha/companies-lookalike method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.companies-search path: /apis/v1/lusha/companies-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.companies-signals path: /apis/v1/lusha/companies-signals method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.contacts-lookalike path: /apis/v1/lusha/contacts-lookalike method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.contacts-signals path: /apis/v1/lusha/contacts-signals method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.enrich-contacts path: /apis/v1/lusha/enrich-contacts method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.people-contacts-enrich path: /apis/v1/lusha/people-contacts-enrich method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: lusha.people-search path: /apis/v1/lusha/people-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:4156136f5bc504ec5f358e741001b66cb80a4ea1045d4612c8cac6c6795356a6 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: lusha x-aisa-catalogs: lusha: title: Lusha description: '' x-aisa-document: facts_hash: 4e06df17a40bff0bc4b39c3818736d6c3748778b27890dcc17931d02d4df8b4b 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/lusha/search-and-enrich-contacts: post: tags: - Lusha summary: Search and Enrich Contacts description: >- 按用量计费；默认请求预估费用：$0.0103 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 operationId: lusha.search-and-enrich-contacts requestBody: required: true content: application/json: schema: type: object required: - contacts properties: reveal: type: array items: enum: - emails - phones type: string description: 'Contact data to reveal: emails, phones, or both.' options: type: object properties: includePartialProfiles: type: boolean description: Whether Lusha may return partial contact profiles. description: Additional contact search options. additionalProperties: false contacts: type: array items: type: object properties: id: type: string description: A known Lusha contact ID. email: type: string description: The contact's known email address. lastName: type: string description: The contact's last name. firstName: type: string description: The contact's first name. companyName: type: string description: The contact's company name. linkedinUrl: type: string description: The contact's LinkedIn profile URL. companyDomain: type: string description: The contact's company domain. clientReferenceId: type: string description: >- Caller-defined reference returned with this contact's result. description: >- A documented set of identifiers used to find one Lusha contact. additionalProperties: false maxItems: 100 minItems: 1 description: >- One to 100 contacts identified by Lusha ID, LinkedIn URL, email, or name and company. additionalProperties: false responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__d46bae7f4d527e0a Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__d46bae7f4d527e0a: type: object properties: status: type: string billing: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__9a60d7a88f63c3f7 results: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__19db5aa5fba29503 requestId: type: string statusReason: type: string statusDescription: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__9a60d7a88f63c3f7: type: object properties: creditsCharged: type: integer resultsReturned: type: integer additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__19db5aa5fba29503: type: object properties: id: type: string tags: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__834d010acb91cc24 error: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__70e00be412f6917b emails: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__e906c6ede41774d8 phones: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a925351812ef4e6e company: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a0608eaf1154236b profile: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__9f36ad367acfb1ec fullName: type: string jobTitle: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__fc732e8765667fe4 lastName: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__fcea575be7f6b65a firstName: type: string updateDate: type: string format: date socialLinks: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__44033a37b03b95c1 partialProfile: type: boolean clientReferenceId: type: string linkedinFollowers: type: integer missingDataPoints: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__611037d91ac24c29 maxItems: 2 previousEmployment: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__96c22ad0dc4da5b2 linkedinConnections: type: integer additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__834d010acb91cc24: type: object properties: id: type: string name: type: string color: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__70e00be412f6917b: type: object properties: code: type: string message: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__e906c6ede41774d8: type: object properties: type: enum: - work - private - unknown type: string email: type: string credits: type: number confidence: type: string dataSource: type: string updateDate: type: string format: date additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a925351812ef4e6e: type: object properties: type: enum: - mobile - direct - work - unknown type: string number: type: string credits: type: number doNotCall: type: boolean dataSource: type: string updateDate: type: string format: date additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a0608eaf1154236b: type: object properties: id: type: string name: type: string domain: type: string industry: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__9f36ad367acfb1ec: type: object properties: awards: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__d7e32225617f4f05 skills: type: array items: type: string courses: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a8b97a8ffb0a8829 certifications: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__3efba676501552a9 additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__fc732e8765667fe4: type: object properties: title: type: string seniority: type: string departments: type: array items: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__fcea575be7f6b65a: type: object properties: city: type: string state: type: string country: type: string continent: type: string coordinates: type: array items: type: number countryIso2: type: string isEuContact: type: boolean additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__44033a37b03b95c1: type: object properties: xUrl: type: string linkedin: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__611037d91ac24c29: type: object properties: type: enum: - email - phone type: string status: enum: - NOT_FOUND - BILLING_FAILED type: string description: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__96c22ad0dc4da5b2: type: object properties: company: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__510e76e2919311ef jobTitle: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__fc732e8765667fe4 additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__d7e32225617f4f05: type: object properties: date: type: string title: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__a8b97a8ffb0a8829: type: object properties: name: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__3efba676501552a9: type: object properties: name: type: string authority: type: string additionalProperties: true Response576A0Ea506F3_connect_LUSHA_SEARCH_AND_ENRICH_CONTACTS__output__510e76e2919311ef: type: object properties: name: type: string domain: type: string additionalProperties: true securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.