> ## 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 > ## Agent Instructions (AIsa) > > - 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`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # Industry Search > Resolve an industry from free text into ranked taxonomy codes for list-generation filters. Resolve an industry from free text into akta's taxonomy codes — 30K+ sub-sectors across 4 hierarchy levels — ranked by similarity. "warehouse automation" returns the exact codes plus adjacent industries you may not have named. Feed the codes into the `industry.industry` filter of [`list generation`](/docs/api-reference/akta/post_list-generate-companies). **First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: `search`, `list_categories` and `get_details` are free, `use` and `batch_use` are billed per call. Setup per client is in [Connect via MCP](/docs/agent-quickstart); the live tool list and what each call costs are on [aisa.one/mcp](https://aisa.one/mcp#connect). [Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/akta/get_industry-search) ## Cost and request rules 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.001 * **Cost contract:** explicit\_zero * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/akta.json GET /apis/v1/akta/industry/search openapi: 3.1.0 info: description: '' title: Akta 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/akta/company/addition-requests - /apis/v1/akta/company/enrichment - /apis/v1/akta/company/search - /apis/v1/akta/industry/search - /apis/v1/akta/list/filter-builder - /apis/v1/akta/list/generate/companies - /apis/v1/akta/status/{request_id} x-aisa-document: facts_hash: d6697de3e5c016d4bf4c7fb0c4b834f38524cf92fb24739a3f461f45df5d3ce2 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '18' response_pending: [] document_hash: sha256:c90c9ff7caab816a3f4309e4ded84c10a15bc10d38f9a61bd8f4289b753a69bd x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: akta x-aisa-catalogs: akta: title: Akta description: '' x-aisa-document: facts_hash: d6697de3e5c016d4bf4c7fb0c4b834f38524cf92fb24739a3f461f45df5d3ce2 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/akta/industry/search: get: tags: - supporting summary: Industry Search description: >- Resolve an industry from free text to ranked industry codes (30K+ sub-sectors, 4-level taxonomy). Free. operationId: get_akta_industry_search parameters: - in: query name: level required: false schema: type: string - in: query name: query required: false schema: type: string responses: '200': description: Industry search results returned content: application/json: schema: type: object properties: data: type: array items: $ref: >- #/components/schemas/Response10C6522D345B_IndustrySearchResult count: type: integer description: Number of industry objects returned in the data array. credits_consumed: type: number format: float example: 0 '204': content: {} description: No content — no industries matched the query. x-aisa-no-content: true default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response10C6522D345B_IndustrySearchResult: type: object properties: code: type: string description: Unique industry code. industry_name: type: string description: Full name of the industry. similarity: type: number format: float description: >- Similarity score between the query and the matched industry, ranging from 0 to 1. Higher values indicate a closer match. securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.