> ## 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 # Company Search with Elasticsearch > Usage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/people-data-labs/search-company-elastic * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/people-data-labs/search-company-elastic` * **Runtime facts:** d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/people-data-labs.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "people-data-labs.search-company-elastic", "method": "POST", "path": "/apis/v1/people-data-labs/search-company-elastic", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "size": { "maximum": 100, "minimum": 1, "type": "integer", "description": "The number of matched company records to return. Must be an integer between 1 and 100, inclusive." }, "query": { "type": "string", "description": "Elasticsearch DSL query string (JSON object) for searching People Data Labs company profiles.\n\n**Supported query types:** term, terms, match, match_phrase, range, exists, bool (must/should/filter/must_not), wildcard, prefix.\n\n**Common Company Fields:** name, display_name, website, industry, employee_count, founded, size, location.country, location.region, location.locality, location.name, tags, linkedin_url, type, summary.\n\n**Location Searches:** Use nested fields: `location.country`, `location.region`, `location.locality`, `location.name`. Example: `{\"term\": {\"location.country\": \"united states\"}}`.\n\n**Important Restrictions:**\n- Do NOT include `size` or `scroll_token` in this query; use the dedicated request fields.\n- Do NOT use `minimum_should_match` in bool queries.\n\nFor complete field mappings, see https://docs.peopledatalabs.com/docs/company-search-api.", "examples": [ "{\"bool\": {\"must\": [{\"term\": {\"industry\": \"computer software\"}}]}}", "{\"range\": {\"employee_count\": {\"gte\": 5000}}}", "{\"bool\": {\"filter\": [{\"range\": {\"founded\": {\"gte\": 2010}}}, {\"term\": {\"location.country\": \"united states\"}}]}}", "{\"match\": {\"name\": \"google\"}}" ] }, "pretty": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, the JSON response will be pretty-printed with human-readable indentation. Defaults to false." }, "titlecase": { "type": "boolean", "default": false, "examples": [ "true", "false" ], "description": "If true, an attempt will be made to title-case relevant text fields in the returned company records. Defaults to false." }, "scroll_token": { "type": "string", "default": "", "examples": [ "627275426f6b656e3432363935383437303232353438373930323030343934383635343734313337", "" ], "description": "A token returned from a previous search response, used for paginating through large result sets. Provide this token to retrieve the next batch of `size` records. Leave empty or omit for the first request." } }, "required": [ "query", "size" ] } } } }, "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.1003, "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" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.1003 USD (not a fixed price). Declared unit rate: \$0.000001 USD per provider\_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.1003 * **Declared unit rate (USD):** 1e-06 * **Billing unit:** provider\_credit * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Declared maximum count/units:** 10000000 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml reference-contracts/people-data-labs.json POST /apis/v1/people-data-labs/search-company-elastic openapi: 3.1.0 info: description: '' title: People Data Labs 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/people-data-labs/companies-enrich - /apis/v1/people-data-labs/companies-search - /apis/v1/people-data-labs/company/enrich - /apis/v1/people-data-labs/company/search - /apis/v1/people-data-labs/enrich-bulk-company-data - /apis/v1/people-data-labs/enrich-bulk-person-data - /apis/v1/people-data-labs/enrich-company-data - /apis/v1/people-data-labs/enrich-person-data - /apis/v1/people-data-labs/identify-person-data - /apis/v1/people-data-labs/people-enrich - /apis/v1/people-data-labs/people-search - /apis/v1/people-data-labs/people-search-elastic - /apis/v1/people-data-labs/search-company-elastic - /apis/v1/people-data-labs/search-company-post x-aisa-document: facts_hash: d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: people-data-labs.companies-enrich path: /apis/v1/people-data-labs/companies-enrich method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: people-data-labs.companies-search path: /apis/v1/people-data-labs/companies-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: people-data-labs.people-enrich path: /apis/v1/people-data-labs/people-enrich method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: people-data-labs.people-search path: /apis/v1/people-data-labs/people-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:fcc357eea49c3a145e5ed0f836a0034070b32bf97d92453e0a56ff91d1d4e687 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: people-data-labs x-aisa-catalogs: people-data-labs: title: People Data Labs description: '' x-aisa-document: facts_hash: d9aafd76ae02b9bcd98e168c52eb69aba6e12890a1eed8da421910f394e8200a 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/people-data-labs/search-company-elastic: post: tags: - People Data Labs summary: Company Search with Elasticsearch description: >- Usage-based billing; Default request estimate: $0.1003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: people-data-labs.search-company-elastic requestBody: required: true content: application/json: schema: type: object properties: size: maximum: 100 minimum: 1 type: integer description: >- The number of matched company records to return. Must be an integer between 1 and 100, inclusive. query: type: string examples: - >- {"bool": {"must": [{"term": {"industry": "computer software"}}]}} - '{"range": {"employee_count": {"gte": 5000}}}' - >- {"bool": {"filter": [{"range": {"founded": {"gte": 2010}}}, {"term": {"location.country": "united states"}}]}} - '{"match": {"name": "google"}}' description: >- Elasticsearch DSL query string (JSON object) for searching People Data Labs company profiles. **Supported query types:** term, terms, match, match_phrase, range, exists, bool (must/should/filter/must_not), wildcard, prefix. **Common Company Fields:** name, display_name, website, industry, employee_count, founded, size, location.country, location.region, location.locality, location.name, tags, linkedin_url, type, summary. **Location Searches:** Use nested fields: `location.country`, `location.region`, `location.locality`, `location.name`. Example: `{"term": {"location.country": "united states"}}`. **Important Restrictions:** - Do NOT include `size` or `scroll_token` in this query; use the dedicated request fields. - Do NOT use `minimum_should_match` in bool queries. For complete field mappings, see https://docs.peopledatalabs.com/docs/company-search-api. pretty: type: boolean default: false examples: - 'true' - 'false' description: >- If true, the JSON response will be pretty-printed with human-readable indentation. Defaults to false. titlecase: type: boolean default: false examples: - 'true' - 'false' description: >- If true, an attempt will be made to title-case relevant text fields in the returned company records. Defaults to false. scroll_token: type: string default: '' examples: - >- 627275426f6b656e3432363935383437303232353438373930323030343934383635343734313337 - '' description: >- A token returned from a previous search response, used for paginating through large result sets. Provide this token to retrieve the next batch of `size` records. Leave empty or omit for the first request. required: - query - size responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__a74b4d831e94f8c0 Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__a74b4d831e94f8c0: type: object required: - query - records - scroll_token - total properties: query: type: string total: type: integer records: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e132828af5abc696 scroll_token: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e132828af5abc696: type: object properties: id: type: string sic: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__747a19c7ca00e242 name: type: string size: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3d498cc8dd55f1c9 tags: type: array items: type: string type: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__be1cf172b8eeb4a3 naics: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__5fff78354a0252c1 ticker: type: string founded: type: integer summary: type: string website: type: string headline: type: string industry: type: string location: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__20b6b1d8f0c1ac14 profiles: type: array items: type: string industry_v2: type: string linkedin_id: type: string twitter_url: type: string display_name: type: string facebook_url: type: string linkedin_url: type: string mic_exchange: type: string linkedin_slug: type: string employee_count: type: integer funding_stages: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61 dataset_version: type: string inferred_revenue: type: string alternative_names: type: array items: type: string last_funding_date: type: string recent_exec_hires: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e6ee6721184f4a9d top_next_employers: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 affiliated_profiles: type: array items: type: string alternative_domains: type: array items: type: string employee_churn_rate: type: object additionalProperties: type: number employee_growth_rate: type: object additionalProperties: type: number latest_funding_stage: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61 total_funding_raised: type: number number_funding_rounds: type: integer average_tenure_by_role: type: object additionalProperties: type: number employee_count_by_role: type: object additionalProperties: type: integer recent_exec_departures: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__9ade69eb098566cf top_previous_employers: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 average_employee_tenure: type: number average_tenure_by_level: type: object additionalProperties: type: number employee_count_by_class: type: object additionalProperties: type: integer employee_count_by_month: type: object additionalProperties: type: integer gross_additions_by_month: type: object additionalProperties: type: integer employee_count_by_country: type: object additionalProperties: type: integer gross_departures_by_month: type: object additionalProperties: type: integer employee_count_by_sub_role: type: object additionalProperties: type: integer top_next_employers_by_role: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 top_next_employers_12_month: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 top_previous_employers_by_role: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 employee_count_by_month_by_role: type: object additionalProperties: type: object additionalProperties: type: integer top_previous_employers_12_month: type: object additionalProperties: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4 employee_count_by_month_by_level: type: object additionalProperties: type: object additionalProperties: type: integer employee_growth_rate_12_month_by_role: type: object additionalProperties: type: number employee_growth_rate_12_month_by_class: type: object additionalProperties: type: number employee_growth_rate_12_month_by_sub_role: type: object additionalProperties: type: number Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__747a19c7ca00e242: type: object properties: sic_code: type: string major_group: type: string industry_group: type: string industry_sector: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3d498cc8dd55f1c9: enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1000 - 1001-5000 - 5001-10000 - 10001+ type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__be1cf172b8eeb4a3: enum: - public - private - public_subsidiary - educational - government - nonprofit type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__5fff78354a0252c1: type: object properties: sector: type: string naics_code: type: string sub_sector: type: string industry_group: type: string naics_industry: type: string national_industry: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__20b6b1d8f0c1ac14: type: object properties: geo: type: string name: type: string metro: type: string region: type: string country: type: string locality: type: string continent: type: string postal_code: type: string address_line_2: type: string street_address: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__3854e01f2bc19c61: enum: - seed - series_a - series_b - series_c - series_d - series_e - series_f - series_g - series_h - series_i - series_j - series_unknown - angel - pre_seed - private_equity - debt_financing - convertible_note - grant - corporate_round - equity_crowdfunding - product_crowdfunding - initial_coin_offering - post_ipo_equity - post_ipo_debt - post_ipo_secondary - secondary_market - non_equity_assistance - funding_round - undisclosed type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__e6ee6721184f4a9d: type: object properties: roles: type: array items: type: string levels: type: array items: type: string pdl_id: type: string job_title: type: string joined_date: type: string previous_company: type: object additionalProperties: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__1fd0c04f04f31ec4: type: object properties: id: type: string count: type: integer display_name: type: string Response576A0Ea506F3_connect_PEOPLEDATALABS_SEARCH_COMPANY_ELASTIC__output__9ade69eb098566cf: type: object properties: roles: type: array items: type: string levels: type: array items: type: string pdl_id: type: string job_title: type: string new_company: type: object additionalProperties: type: string departed_date: type: string securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.