> ## 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 # Get Brand > Usage-based billing; Default request estimate: $0.0253 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/context-dev/get-brand * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/context-dev/get-brand` * **Runtime facts:** 3068b7678674e2539daed47d533143c7d5bf21072a81e6aac34d7bd71ed57eb3 [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/context-dev.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "context-dev.get-brand", "method": "POST", "path": "/apis/v1/context-dev/get-brand", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "lookup_type", "identifier" ], "properties": { "city": { "type": "string", "description": "City hint for transaction lookup." }, "tags": { "type": "array", "items": { "type": "string" }, "maxItems": 20, "description": "Up to 20 usage-tracking tags, each 1-50 characters." }, "phone": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" } ], "description": "Phone-number hint for transaction lookup, as text or a number." }, "country": { "type": "string", "description": "Country hint for name or transaction lookup." }, "max_speed": { "type": "boolean", "default": false, "description": "Prefer faster but potentially less comprehensive retrieval." }, "identifier": { "type": "string", "examples": [ "stripe.com" ], "minLength": 1, "description": "Domain, company name, work email, ticker, full direct URL, or transaction descriptor matching lookup_type." }, "max_age_ms": { "type": "integer", "minimum": 0, "description": "Maximum cached brand-data age in milliseconds. The provider clamps values to 1 day through 1 year." }, "timeout_ms": { "type": "integer", "maximum": 300000, "minimum": 1000, "description": "Provider timeout in milliseconds, from 1000 through 300000." }, "lookup_type": { "enum": [ "domain", "name", "email", "ticker", "direct_url", "transaction" ], "type": "string", "description": "Kind of identifier supplied in identifier. Selects domain, company name, work email, stock ticker, direct URL, or transaction lookup." }, "force_language": { "enum": [ "afrikaans", "albanian", "amharic", "arabic", "armenian", "assamese", "aymara", "azeri", "basque", "belarusian", "bengali", "bosnian", "bulgarian", "burmese", "cantonese", "catalan", "cebuano", "chinese", "corsican", "croatian", "czech", "danish", "dutch", "english", "esperanto", "estonian", "farsi", "fijian", "finnish", "french", "galician", "georgian", "german", "greek", "guarani", "gujarati", "haitian-creole", "hausa", "hawaiian", "hebrew", "hindi", "hmong", "hungarian", "icelandic", "igbo", "indonesian", "irish", "italian", "japanese", "javanese", "kannada", "kazakh", "khmer", "kinyarwanda", "korean", "kurdish", "kyrgyz", "lao", "latin", "latvian", "lingala", "lithuanian", "luxembourgish", "macedonian", "malagasy", "malay", "malayalam", "maltese", "maori", "marathi", "mongolian", "nepali", "norwegian", "odia", "oromo", "pashto", "pidgin", "polish", "portuguese", "punjabi", "quechua", "romanian", "russian", "samoan", "scottish-gaelic", "serbian", "sesotho", "shona", "sindhi", "sinhala", "slovak", "slovene", "somali", "spanish", "sundanese", "swahili", "swedish", "tagalog", "tajik", "tamil", "tatar", "telugu", "thai", "tibetan", "tigrinya", "tongan", "tswana", "turkish", "turkmen", "ukrainian", "urdu", "uyghur", "uzbek", "vietnamese", "welsh", "wolof", "xhosa", "yiddish", "yoruba", "zulu" ], "type": "string", "description": "Provider-supported output language name, such as english or french." }, "ticker_exchange": { "type": "string", "minLength": 1, "description": "Stock exchange identifier for ticker lookup; omit to let Context.dev default to NASDAQ." }, "high_confidence_only": { "type": "boolean", "default": false, "description": "For transaction lookup, require additional match verification." }, "merchant_category_code": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "number" } ], "description": "Merchant Category Code hint for transaction lookup, as text or a number." } } } } } }, "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.0253, "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.0253 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.0253 * **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/context-dev.json POST /apis/v1/context-dev/get-brand openapi: 3.1.0 info: description: '' title: Context.dev 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/context-dev/extract-structured-web-data - /apis/v1/context-dev/get-brand - /apis/v1/context-dev/get-website-styleguide - /apis/v1/context-dev/search-brands - /apis/v1/context-dev/web-crawl - /apis/v1/context-dev/web-map - /apis/v1/context-dev/web-scrape - /apis/v1/context-dev/web-search x-aisa-document: facts_hash: 3068b7678674e2539daed47d533143c7d5bf21072a81e6aac34d7bd71ed57eb3 generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: context-dev.web-map path: /apis/v1/context-dev/web-map method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: context-dev.web-scrape path: /apis/v1/context-dev/web-scrape method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: context-dev.web-search path: /apis/v1/context-dev/web-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:7e355df5f13590c3b7614e884779c7588201d481ec62bc5714c2f3403c0e9ae0 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: context-dev x-aisa-catalogs: context-dev: title: Context.dev description: '' x-aisa-document: facts_hash: 3068b7678674e2539daed47d533143c7d5bf21072a81e6aac34d7bd71ed57eb3 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/context-dev/get-brand: post: tags: - Context.dev summary: Get Brand description: >- Usage-based billing; Default request estimate: $0.0253 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: context-dev.get-brand requestBody: required: true content: application/json: schema: type: object required: - lookup_type - identifier properties: city: type: string description: City hint for transaction lookup. tags: type: array items: type: string maxItems: 20 description: Up to 20 usage-tracking tags, each 1-50 characters. phone: anyOf: - type: string - type: integer - type: number description: >- Phone-number hint for transaction lookup, as text or a number. country: type: string description: Country hint for name or transaction lookup. max_speed: type: boolean default: false description: Prefer faster but potentially less comprehensive retrieval. identifier: type: string examples: - stripe.com minLength: 1 description: >- Domain, company name, work email, ticker, full direct URL, or transaction descriptor matching lookup_type. max_age_ms: type: integer minimum: 0 description: >- Maximum cached brand-data age in milliseconds. The provider clamps values to 1 day through 1 year. timeout_ms: type: integer maximum: 300000 minimum: 1000 description: Provider timeout in milliseconds, from 1000 through 300000. lookup_type: enum: - domain - name - email - ticker - direct_url - transaction type: string description: >- Kind of identifier supplied in identifier. Selects domain, company name, work email, stock ticker, direct URL, or transaction lookup. force_language: enum: - afrikaans - albanian - amharic - arabic - armenian - assamese - aymara - azeri - basque - belarusian - bengali - bosnian - bulgarian - burmese - cantonese - catalan - cebuano - chinese - corsican - croatian - czech - danish - dutch - english - esperanto - estonian - farsi - fijian - finnish - french - galician - georgian - german - greek - guarani - gujarati - haitian-creole - hausa - hawaiian - hebrew - hindi - hmong - hungarian - icelandic - igbo - indonesian - irish - italian - japanese - javanese - kannada - kazakh - khmer - kinyarwanda - korean - kurdish - kyrgyz - lao - latin - latvian - lingala - lithuanian - luxembourgish - macedonian - malagasy - malay - malayalam - maltese - maori - marathi - mongolian - nepali - norwegian - odia - oromo - pashto - pidgin - polish - portuguese - punjabi - quechua - romanian - russian - samoan - scottish-gaelic - serbian - sesotho - shona - sindhi - sinhala - slovak - slovene - somali - spanish - sundanese - swahili - swedish - tagalog - tajik - tamil - tatar - telugu - thai - tibetan - tigrinya - tongan - tswana - turkish - turkmen - ukrainian - urdu - uyghur - uzbek - vietnamese - welsh - wolof - xhosa - yiddish - yoruba - zulu type: string description: >- Provider-supported output language name, such as english or french. ticker_exchange: type: string minLength: 1 description: >- Stock exchange identifier for ticker lookup; omit to let Context.dev default to NASDAQ. high_confidence_only: type: boolean default: false description: >- For transaction lookup, require additional match verification. merchant_category_code: anyOf: - type: string - type: integer - type: number description: >- Merchant Category Code hint for transaction lookup, as text or a number. responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__824eb2e891c110f9 Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__824eb2e891c110f9: type: object required: - brand properties: brand: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__7d565ccea7d287d6 key_metadata: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__54a748042674849e Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__7d565ccea7d287d6: type: object properties: email: type: string links: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__5952b39c8810d2f8 logos: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__e39cbd1393350929 phone: type: string stock: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__c81c643be401f035 title: type: string colors: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__ea86eac7d052149d domain: type: string slogan: type: string address: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__34def8480943220d is_nsfw: type: boolean socials: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__27493ac2153ab670 backdrops: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__72da80f4639c7978 employees: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__7518f3d5a64b5def industries: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__5680bc31b645ccba description: type: string primary_language: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__54a748042674849e: type: object required: - credits_consumed - credits_remaining properties: credits_consumed: type: integer credits_remaining: type: integer additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__5952b39c8810d2f8: type: object properties: blog: type: string terms: type: string careers: type: string contact: type: string pricing: type: string privacy: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__e39cbd1393350929: type: object properties: url: type: string mode: type: string type: type: string colors: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__ea86eac7d052149d resolution: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__0a310999f1817366 additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__c81c643be401f035: type: object properties: ticker: type: string exchange: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__ea86eac7d052149d: type: object properties: hex: type: string name: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__34def8480943220d: type: object properties: city: type: string street: type: string country: type: string state_code: type: string postal_code: type: string country_code: type: string state_province: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__27493ac2153ab670: type: object properties: url: type: string type: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__72da80f4639c7978: type: object properties: url: type: string colors: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__ea86eac7d052149d resolution: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__0a310999f1817366 additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__7518f3d5a64b5def: type: object properties: exact: type: integer range: type: string additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__5680bc31b645ccba: type: object properties: eic: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__77dc4bdc5fdee6ec additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__0a310999f1817366: type: object properties: width: type: integer height: type: integer aspect_ratio: type: number additionalProperties: true Response576A0Ea506F3_connect_CONTEXT_DEV_GET_BRAND__output__77dc4bdc5fdee6ec: type: object required: - industry - subindustry properties: industry: type: string subindustry: 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.