> ## 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 # Yelp business search by description and location > answers arrive in `organic_results`. Usage-based billing; Default request estimate: $0.015 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:** GET /apis/v1/serpapi/yelp-search * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/serpapi/yelp-search` * **engine:** query; required * **find\_desc:** query; optional * **find\_loc:** query; required * **Runtime facts:** 1d8d2010628130bd331b470b564dd1cd5784989899ccf3e384a8de02a69e0558 [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/serpapi.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "serpapi.yelp-search", "method": "GET", "path": "/apis/v1/serpapi/yelp-search", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "examples": { "default": { "value": "yelp" }, "minimal": { "value": "yelp" } }, "in": "query", "name": "engine", "required": true, "schema": { "enum": [ "yelp" ], "minLength": 1, "type": "string" } }, { "name": "find_desc", "in": "query", "required": false, "schema": { "type": "string", "description": "search query, e.g. business type", "examples": [ "Coffee" ] } }, { "name": "find_loc", "in": "query", "required": true, "schema": { "type": "string", "description": "location string; the only strictly required param besides engine", "examples": [ "New York, NY, USA" ] } } ], "security": [ { "bearerAuth": [] } ], "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.015, "estimate_source": "profile_seed", "evidence_source": "response_header", "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.015 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.015 * **Declared unit rate (USD):** 1e-06 * **Billing unit:** provider\_credit * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Settlement evidence source:** response\_header ## OpenAPI ````yaml reference-contracts/serpapi.json GET /apis/v1/serpapi/yelp-search openapi: 3.1.0 info: description: '' title: SerpApi 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/serpapi/amazon-product - /apis/v1/serpapi/amazon-search - /apis/v1/serpapi/app-store-search-apps - /apis/v1/serpapi/baidu-news - /apis/v1/serpapi/baidu-search - /apis/v1/serpapi/bing-copilot - /apis/v1/serpapi/bing-images - /apis/v1/serpapi/bing-maps - /apis/v1/serpapi/bing-news - /apis/v1/serpapi/bing-search - /apis/v1/serpapi/bing-shopping - /apis/v1/serpapi/bing-videos - /apis/v1/serpapi/brave-ai-mode - /apis/v1/serpapi/duck-duck-go-light-search - /apis/v1/serpapi/duck-duck-go-maps - /apis/v1/serpapi/duck-duck-go-search - /apis/v1/serpapi/duckduckgo-light - /apis/v1/serpapi/duckduckgo-maps - /apis/v1/serpapi/duckduckgo-news - /apis/v1/serpapi/duckduckgo-search - /apis/v1/serpapi/ebay-product - /apis/v1/serpapi/ebay-search - /apis/v1/serpapi/event-search - /apis/v1/serpapi/facebook-profile - /apis/v1/serpapi/finance-search - /apis/v1/serpapi/get-facebook-profile - /apis/v1/serpapi/get-google-about-this-result - /apis/v1/serpapi/get-google-hotels-autocomplete-suggestions - /apis/v1/serpapi/get-google-images-related-content - /apis/v1/serpapi/get-google-patent-details - /apis/v1/serpapi/google-ads - /apis/v1/serpapi/google-ads-transparency - /apis/v1/serpapi/google-ai-mode - /apis/v1/serpapi/google-ai-overview - /apis/v1/serpapi/google-events - /apis/v1/serpapi/google-finance - /apis/v1/serpapi/google-flights - /apis/v1/serpapi/google-forums-search - /apis/v1/serpapi/google-hotels - /apis/v1/serpapi/google-images - /apis/v1/serpapi/google-jobs - /apis/v1/serpapi/google-jobs-search - /apis/v1/serpapi/google-keywords-ideas - /apis/v1/serpapi/google-lens - /apis/v1/serpapi/google-lens-search - /apis/v1/serpapi/google-light - /apis/v1/serpapi/google-light-search - /apis/v1/serpapi/google-local - /apis/v1/serpapi/google-maps - /apis/v1/serpapi/google-maps-search - /apis/v1/serpapi/google-news - /apis/v1/serpapi/google-patents - /apis/v1/serpapi/google-play-product - /apis/v1/serpapi/google-play-search-apps - /apis/v1/serpapi/google-scholar - /apis/v1/serpapi/google-scholar-author - /apis/v1/serpapi/google-scholar-cite - /apis/v1/serpapi/google-serp-organic - /apis/v1/serpapi/google-shopping - /apis/v1/serpapi/google-trends - /apis/v1/serpapi/google-videos - /apis/v1/serpapi/google-videos-light - /apis/v1/serpapi/home-depot-search - /apis/v1/serpapi/hotel-search - /apis/v1/serpapi/image-search - /apis/v1/serpapi/instagram-profile - /apis/v1/serpapi/naver-ai-overview - /apis/v1/serpapi/naver-search - /apis/v1/serpapi/news-search - /apis/v1/serpapi/open-table-reviews - /apis/v1/serpapi/play-search - /apis/v1/serpapi/scholar-search - /apis/v1/serpapi/search - /apis/v1/serpapi/search-apple-app-store - /apis/v1/serpapi/search-google-images-light - /apis/v1/serpapi/search-google-local-services - /apis/v1/serpapi/search-public-google-ads - /apis/v1/serpapi/search-yelp - /apis/v1/serpapi/shopping-search - /apis/v1/serpapi/trends-search - /apis/v1/serpapi/tripadvisor-search - /apis/v1/serpapi/walmart-product - /apis/v1/serpapi/walmart-search - /apis/v1/serpapi/yahoo-images - /apis/v1/serpapi/yahoo-search - /apis/v1/serpapi/yahoo-videos - /apis/v1/serpapi/yandex-images - /apis/v1/serpapi/yandex-images-search - /apis/v1/serpapi/yandex-search - /apis/v1/serpapi/yandex-videos - /apis/v1/serpapi/yelp-search - /apis/v1/serpapi/you-tube-search - /apis/v1/serpapi/youtube-search-videos x-aisa-document: facts_hash: 1d8d2010628130bd331b470b564dd1cd5784989899ccf3e384a8de02a69e0558 generator_version: '3' protocol_version: '1' schema_version: '1' seed_month: 2026-10 composer_version: '28' response_pending: - operation_id: serpapi.amazon-product path: /apis/v1/serpapi/amazon-product method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.amazon-search path: /apis/v1/serpapi/amazon-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.app-store-search-apps path: /apis/v1/serpapi/app-store-search-apps method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.baidu-news path: /apis/v1/serpapi/baidu-news method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.baidu-search path: /apis/v1/serpapi/baidu-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-copilot path: /apis/v1/serpapi/bing-copilot method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-images path: /apis/v1/serpapi/bing-images method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-news path: /apis/v1/serpapi/bing-news method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-search path: /apis/v1/serpapi/bing-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-shopping path: /apis/v1/serpapi/bing-shopping method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.bing-videos path: /apis/v1/serpapi/bing-videos method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.brave-ai-mode path: /apis/v1/serpapi/brave-ai-mode method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.duck-duck-go-light-search path: /apis/v1/serpapi/duck-duck-go-light-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.duckduckgo-light path: /apis/v1/serpapi/duckduckgo-light method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.duckduckgo-maps path: /apis/v1/serpapi/duckduckgo-maps method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.duckduckgo-news path: /apis/v1/serpapi/duckduckgo-news method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.duckduckgo-search path: /apis/v1/serpapi/duckduckgo-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.ebay-product path: /apis/v1/serpapi/ebay-product method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.ebay-search path: /apis/v1/serpapi/ebay-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.facebook-profile path: /apis/v1/serpapi/facebook-profile method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.get-google-about-this-result path: /apis/v1/serpapi/get-google-about-this-result method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.get-google-hotels-autocomplete-suggestions path: /apis/v1/serpapi/get-google-hotels-autocomplete-suggestions method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.get-google-images-related-content path: /apis/v1/serpapi/get-google-images-related-content method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.get-google-patent-details path: /apis/v1/serpapi/get-google-patent-details method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-ads path: /apis/v1/serpapi/google-ads method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-ads-transparency path: /apis/v1/serpapi/google-ads-transparency method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-ai-mode path: /apis/v1/serpapi/google-ai-mode method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-ai-overview path: /apis/v1/serpapi/google-ai-overview method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-events path: /apis/v1/serpapi/google-events method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-finance path: /apis/v1/serpapi/google-finance method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-flights path: /apis/v1/serpapi/google-flights method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-forums-search path: /apis/v1/serpapi/google-forums-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-hotels path: /apis/v1/serpapi/google-hotels method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-images path: /apis/v1/serpapi/google-images method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-jobs path: /apis/v1/serpapi/google-jobs method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-jobs-search path: /apis/v1/serpapi/google-jobs-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-keywords-ideas path: /apis/v1/serpapi/google-keywords-ideas method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-lens path: /apis/v1/serpapi/google-lens method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-light path: /apis/v1/serpapi/google-light method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-light-search path: /apis/v1/serpapi/google-light-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-local path: /apis/v1/serpapi/google-local method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-maps path: /apis/v1/serpapi/google-maps method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-news path: /apis/v1/serpapi/google-news method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-patents path: /apis/v1/serpapi/google-patents method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-play-product path: /apis/v1/serpapi/google-play-product method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-play-search-apps path: /apis/v1/serpapi/google-play-search-apps method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-scholar path: /apis/v1/serpapi/google-scholar method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-serp-organic path: /apis/v1/serpapi/google-serp-organic method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-shopping path: /apis/v1/serpapi/google-shopping method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-trends path: /apis/v1/serpapi/google-trends method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-videos path: /apis/v1/serpapi/google-videos method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.google-videos-light path: /apis/v1/serpapi/google-videos-light method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.home-depot-search path: /apis/v1/serpapi/home-depot-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.hotel-search path: /apis/v1/serpapi/hotel-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.instagram-profile path: /apis/v1/serpapi/instagram-profile method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.naver-ai-overview path: /apis/v1/serpapi/naver-ai-overview method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.naver-search path: /apis/v1/serpapi/naver-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.open-table-reviews path: /apis/v1/serpapi/open-table-reviews method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.play-search path: /apis/v1/serpapi/play-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.search-apple-app-store path: /apis/v1/serpapi/search-apple-app-store method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.search-google-local-services path: /apis/v1/serpapi/search-google-local-services method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.search-public-google-ads path: /apis/v1/serpapi/search-public-google-ads method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.tripadvisor-search path: /apis/v1/serpapi/tripadvisor-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.walmart-product path: /apis/v1/serpapi/walmart-product method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.walmart-search path: /apis/v1/serpapi/walmart-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yahoo-images path: /apis/v1/serpapi/yahoo-images method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yahoo-search path: /apis/v1/serpapi/yahoo-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yahoo-videos path: /apis/v1/serpapi/yahoo-videos method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yandex-images path: /apis/v1/serpapi/yandex-images method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yandex-images-search path: /apis/v1/serpapi/yandex-images-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yandex-search path: /apis/v1/serpapi/yandex-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yandex-videos path: /apis/v1/serpapi/yandex-videos method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.yelp-search path: /apis/v1/serpapi/yelp-search method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.you-tube-search path: /apis/v1/serpapi/you-tube-search method: POST statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: serpapi.youtube-search-videos path: /apis/v1/serpapi/youtube-search-videos method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:0a3d81b177cc3032030040480fa81ea93d74d80e98c1a46531156a46f060df86 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: serpapi x-aisa-catalogs: serpapi: title: SerpApi description: '' x-aisa-document: facts_hash: 1d8d2010628130bd331b470b564dd1cd5784989899ccf3e384a8de02a69e0558 generator_version: '3' protocol_version: '1' schema_version: '1' seed_month: 2026-10 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/serpapi/yelp-search: get: tags: - SerpApi summary: Yelp business search by description and location description: >- answers arrive in `organic_results`. Usage-based billing; Default request estimate: $0.015 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: serpapi.yelp-search parameters: - examples: default: value: yelp minimal: value: yelp in: query name: engine required: true schema: enum: - yelp minLength: 1 type: string - name: find_desc in: query required: false schema: type: string description: search query, e.g. business type examples: - Coffee - name: find_loc in: query required: true schema: type: string description: location string; the only strictly required param besides engine examples: - New York, NY, USA responses: '200': description: Successful response 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 GET \ --url 'https://api.aisa.one/apis/v1/serpapi/yelp-search?engine=yelp&find_loc=New+York%2C+NY%2C+USA' \ --header 'Authorization: Bearer ' components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.