{
  "id": "litescrape.yelp.search",
  "object": "tool",
  "name": "Search Yelp",
  "summary": "Search Yelp businesses by location, category, terms, map area, and sort order.",
  "description": "Search Yelp for businesses in a location. Returns organic_results (position, name, rating, review count, categories, price, address, phone, and the place_id for the reviews endpoint), ads_results, filters, and pagination. Supports search terms or a category, recommended, rating, or review-count ordering, Yelp attribute filters, a map-bounds token, a localized Yelp domain, and offset paging. For a business's reviews pass its place_id to yelp/reviews. Suited for local lead lists, competitor discovery, and review sourcing.\n\nRaw litescrape#yelp/search endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://litescrape.com/docs/yelp-search).",
  "category": "lookup",
  "hosted_by": "Litescrape",
  "runtime": "partner",
  "side_effects": false,
  "status": "live",
  "credits": 0,
  "price": null,
  "providers": [
    {
      "id": "litescrape",
      "name": "Litescrape",
      "price": null,
      "own_key_only": true
    }
  ],
  "mcp_name": "litescrape_yelp_search",
  "input_schema": {
    "type": "object",
    "properties": {
      "queryParams": {
        "type": "object",
        "properties": {
          "find_loc": {
            "type": "string",
            "minLength": 1,
            "description": "Search location, such as a city or neighborhood."
          },
          "find_desc": {
            "type": "string",
            "minLength": 1,
            "description": "Business name, category, or search terms."
          },
          "yelp_domain": {
            "type": "string",
            "pattern": "^www\\.yelp\\.[a-z]{2,3}(\\.[a-z]{2,3})?$",
            "description": "Localized Yelp hostname, such as 'www.yelp.co.uk'. Default 'www.yelp.com'."
          },
          "l": {
            "type": "string",
            "minLength": 1,
            "description": "Yelp-native map bounds token."
          },
          "cflt": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]+$",
            "description": "Yelp category identifier, such as 'coffee' or 'restaurants'."
          },
          "sortby": {
            "type": "string",
            "enum": [
              "recommended",
              "rating",
              "review_count"
            ],
            "description": "Result order. Default 'recommended'."
          },
          "attrs": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Yelp attribute filters, such as ['open_now', 'price.1']. Comma-separated on the wire."
          },
          "start": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000,
            "description": "Result offset, 0-10,000. Default 0."
          }
        },
        "required": [
          "find_loc"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "queryParams"
    ],
    "additionalProperties": false
  },
  "kind": "endpoint"
}