{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "",
    "title": "Yelp",
    "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/yelp/business-reviews",
      "/apis/v1/yelp/business-search",
      "/apis/v1/yelp/businesses/search",
      "/apis/v1/yelp/businesses/{alias}",
      "/apis/v1/yelp/businesses/{alias}/photos",
      "/apis/v1/yelp/businesses/{alias}/reviews"
    ],
    "x-aisa-document": {
      "facts_hash": "1e5a5cb00ecdf714483ceba8e978100d14806483fa255c5507ca0f694838f4f1",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "27",
      "response_pending": [
        {
          "operation_id": "yelp.businesses.search",
          "path": "/apis/v1/yelp/businesses/search",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "yelp.businesses.alias",
          "path": "/apis/v1/yelp/businesses/{alias}",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "yelp.businesses.alias.photos",
          "path": "/apis/v1/yelp/businesses/{alias}/photos",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "yelp.businesses.alias.reviews",
          "path": "/apis/v1/yelp/businesses/{alias}/reviews",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        }
      ],
      "document_hash": "sha256:bfa6d7cb6ed6c7712ea359bb90d9b9d97491aceb4307ea8e81d6364bb39bbd17"
    },
    "x-aisa-plans": {
      "builder": 1.0,
      "display_plan": "payg",
      "payg": 1.0,
      "similarweb_payg": 1.0,
      "team": 1.0,
      "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
    },
    "x-aisa-provider": "yelp",
    "x-aisa-catalogs": {
      "yelp": {
        "title": "Yelp",
        "description": "",
        "x-aisa-document": {
          "facts_hash": "1e5a5cb00ecdf714483ceba8e978100d14806483fa255c5507ca0f694838f4f1",
          "generator_version": "3",
          "protocol_version": "1",
          "schema_version": "1"
        },
        "x-aisa-plans": {
          "builder": 1.0,
          "display_plan": "payg",
          "payg": 1.0,
          "similarweb_payg": 1.0,
          "team": 1.0,
          "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
        },
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          }
        }
      }
    }
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "openapi": "3.1.0",
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "paths": {
    "/apis/v1/yelp/businesses/search": {
      "get": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.014 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.014 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "yelp.businesses.search",
        "parameters": [
          {
            "examples": {
              "default": {
                "value": "example"
              },
              "minimal": {
                "value": "example"
              }
            },
            "in": "query",
            "name": "location",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "maximum": 9223372036854775807,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "examples": {
              "default": {
                "value": "nike"
              },
              "minimal": {
                "value": "nike"
              }
            },
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "enum": [
                "highest_rated",
                "most_reviewed",
                "recommended"
              ],
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Search Yelp businesses",
        "tags": [
          "Yelp"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "social",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "default_request_estimate_usd": 0.014,
          "estimate_source": "profile_seed",
          "evidence_source": "response_body",
          "maximum_units": 1,
          "unit": "provider_credit",
          "unit_rate_usd": 0.014
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": false
        },
        "x-aisa-response-passthrough": true,
        "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b",
        "x-aisa-response-upstream-path-sha256": "461e3821b8fbde1419100b648d55dc52c591c2a127c48ab4ed22fb421c47e4f9",
        "x-aisa-revision": {
          "customer_pricing_ref": "b35ec6a8f68b",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "fa2c6be6a13e"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "yelp",
        "x-aisa-runtime-operation": {
          "operation_id": "yelp.businesses.search",
          "method": "GET",
          "path": "/apis/v1/yelp/businesses/search"
        },
        "x-aisa-response-pending": {
          "operation_id": "yelp.businesses.search",
          "path": "/apis/v1/yelp/businesses/search",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/yelp/businesses/search?location=example&query=nike' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/yelp/yelp-businesses-search"
      }
    },
    "/apis/v1/yelp/businesses/{alias}": {
      "get": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.028 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.014 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "yelp.businesses.alias",
        "parameters": [
          {
            "examples": {
              "default": {
                "value": "example"
              },
              "minimal": {
                "value": "example"
              }
            },
            "in": "path",
            "name": "alias",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Get Yelp business details",
        "tags": [
          "Yelp"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "social",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "default_request_estimate_usd": 0.028,
          "estimate_source": "profile_seed",
          "evidence_source": "response_body",
          "maximum_units": 2,
          "unit": "provider_credit",
          "unit_rate_usd": 0.014
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": false
        },
        "x-aisa-response-passthrough": true,
        "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b",
        "x-aisa-response-upstream-path-sha256": "d95570b79c8f5f2e3d7ffd85cdf401d029508363aec292bb09ef14791e85f994",
        "x-aisa-revision": {
          "customer_pricing_ref": "b35ec6a8f68b",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "9e64f1431f05"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "yelp",
        "x-aisa-runtime-operation": {
          "operation_id": "yelp.businesses.alias",
          "method": "GET",
          "path": "/apis/v1/yelp/businesses/{alias}"
        },
        "x-aisa-response-pending": {
          "operation_id": "yelp.businesses.alias",
          "path": "/apis/v1/yelp/businesses/{alias}",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url https://api.aisa.one/apis/v1/yelp/businesses/example \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/yelp/yelp-businesses-alias"
      }
    },
    "/apis/v1/yelp/businesses/{alias}/photos": {
      "get": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.028 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.014 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "yelp.businesses.alias.photos",
        "parameters": [
          {
            "examples": {
              "default": {
                "value": "example"
              },
              "minimal": {
                "value": "example"
              }
            },
            "in": "path",
            "name": "alias",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 16384,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "List Yelp business photos",
        "tags": [
          "Yelp"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "social",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "default_request_estimate_usd": 0.028,
          "estimate_source": "profile_seed",
          "evidence_source": "response_body",
          "maximum_units": 2,
          "unit": "provider_credit",
          "unit_rate_usd": 0.014
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": false
        },
        "x-aisa-response-passthrough": true,
        "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b",
        "x-aisa-response-upstream-path-sha256": "91b8bc02c87a29d3538720c1ce980e5a070fd83204dcfa45f38276f644fb6d6f",
        "x-aisa-revision": {
          "customer_pricing_ref": "b35ec6a8f68b",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "acc80a396dd9"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "yelp",
        "x-aisa-runtime-operation": {
          "operation_id": "yelp.businesses.alias.photos",
          "method": "GET",
          "path": "/apis/v1/yelp/businesses/{alias}/photos"
        },
        "x-aisa-response-pending": {
          "operation_id": "yelp.businesses.alias.photos",
          "path": "/apis/v1/yelp/businesses/{alias}/photos",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url https://api.aisa.one/apis/v1/yelp/businesses/example/photos \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/yelp/yelp-businesses-alias-photos"
      }
    },
    "/apis/v1/yelp/businesses/{alias}/reviews": {
      "get": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.028 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.014 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "yelp.businesses.alias.reviews",
        "parameters": [
          {
            "examples": {
              "default": {
                "value": "example"
              },
              "minimal": {
                "value": "example"
              }
            },
            "in": "path",
            "name": "alias",
            "required": true,
            "schema": {
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "examples": {
              "default": {
                "value": "not_recommended"
              },
              "minimal": {
                "value": "not_recommended"
              }
            },
            "in": "query",
            "name": "category",
            "required": true,
            "schema": {
              "enum": [
                "not_recommended",
                "recommended",
                "removed"
              ],
              "maxLength": 4096,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 16384,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "List Yelp business reviews",
        "tags": [
          "Yelp"
        ],
        "x-aisa-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "social",
        "x-aisa-pricing": {
          "cost_contract": "response_units",
          "customer_multiplier": 1.0,
          "customer_pricing": "provider_cost_multiplier",
          "default_request_estimate_usd": 0.028,
          "estimate_source": "profile_seed",
          "evidence_source": "response_body",
          "maximum_units": 2,
          "unit": "provider_credit",
          "unit_rate_usd": 0.014
        },
        "x-aisa-query-policy": {
          "ignore_undeclared": false,
          "request_wins": false
        },
        "x-aisa-response-passthrough": true,
        "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b",
        "x-aisa-response-upstream-path-sha256": "080ac8f3f410426413c99066d2f0a492a0748c0b69dbd51fa58689f9e8d8f5e6",
        "x-aisa-revision": {
          "customer_pricing_ref": "b35ec6a8f68b",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "23cce28eff61"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "runtime",
        "x-aisa-catalog-id": "yelp",
        "x-aisa-runtime-operation": {
          "operation_id": "yelp.businesses.alias.reviews",
          "method": "GET",
          "path": "/apis/v1/yelp/businesses/{alias}/reviews"
        },
        "x-aisa-response-pending": {
          "operation_id": "yelp.businesses.alias.reviews",
          "path": "/apis/v1/yelp/businesses/{alias}/reviews",
          "method": "GET",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n  --url 'https://api.aisa.one/apis/v1/yelp/businesses/example/reviews?category=not_recommended' \\\n  --header 'Authorization: Bearer <token>'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/yelp/yelp-businesses-alias-reviews"
      }
    }
  }
}