{"uid":"cap_VHF5pjhxCbX-PubtPxGWW","slug":"agents-litescrape-com-search-yelp-businesses-941e86b4","name":"Search Yelp Businesses","description":"Search Yelp businesses by location and category.\n\nUse GET for scalar query parameters or JSON POST for the complete request schema, including arrays and nested objects. See the schema for field limits and conditional rules. Failures are not billed.\n\nOptional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback.","url":"https://agents.litescrape.com/api/yelp/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["find_loc"],"properties":{"l":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"L","default":null,"description":"Optional Yelp-native map bounds token.","x-litescrape":{"group":0,"label":"Map bounds","summary":"Optional Yelp-native map bounds token.","formGroup":0,"placeholder":"g:-97.80,30.20,-97.70,30.30"}},"cflt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cflt","default":null,"description":"Yelp category identifier containing letters, numbers, _ or -.","x-litescrape":{"group":0,"label":"Category","summary":"Yelp category identifier containing letters, numbers, _ or -.","formGroup":0,"placeholder":"coffee"}},"attrs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attrs","default":null,"description":"Yelp-native comma-separated attribute filters.","x-litescrape":{"group":0,"label":"Attributes","summary":"Yelp-native comma-separated attribute filters.","formGroup":0,"placeholder":"OutdoorSeating"}},"start":{"type":"integer","title":"Start","default":0,"description":"Result offset from 0 through 10,000.","x-litescrape":{"kind":"number","group":0,"label":"Start offset","summary":"Result offset from 0 through 10,000.","formGroup":0,"placeholder":"0"}},"sortby":{"enum":["recommended","rating","review_count"],"type":"string","title":"Sortby","default":"recommended","description":"Native Yelp ordering.","x-litescrape":{"kind":"select","group":0,"label":"Sort","options":[{"label":"Recommended","value":"recommended"},{"label":"Rating","value":"rating"},{"label":"Review count","value":"review_count"}],"summary":"Native Yelp ordering.","formGroup":0}},"timeout":{"type":"number","maximum":90,"description":"Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.","exclusiveMinimum":0},"find_loc":{"type":"string","title":"Find Loc","description":"Required Yelp search location.","x-litescrape":{"group":0,"label":"Location","summary":"Required Yelp search location.","formGroup":0,"placeholder":"Austin, TX"}},"location":{"type":"string","description":"Location for search"},"find_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Find Desc","default":null,"description":"Business name, category, or search terms.","x-litescrape":{"group":0,"label":"Description","summary":"Business name, category, or search terms.","formGroup":0,"placeholder":"coffee"}},"yelp_domain":{"type":"string","title":"Yelp Domain","default":"www.yelp.com","description":"Supported Yelp hostname. Results use the language of the selected domain.","x-litescrape":{"group":0,"label":"Yelp domain","summary":"Supported Yelp hostname. Results use the language of the selected domain.","formGroup":0,"placeholder":"www.yelp.com"}}}},"responseSchema":{"type":"object","title":"Response","properties":{"faqs":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsefaqitem","properties":{"question":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Question","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Faqs","default":null},"filters":{"anyOf":[{"type":"object","title":"Responsefilters","properties":{"price":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsefilterspriceitem","properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","default":null},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}}},{"type":"null"}],"title":"Price","default":null},"features":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responsefiltersfeatureitem","properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","default":null},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","default":null},"selected":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Selected","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}}},{"type":"null"}],"title":"Features","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"pagination":{"anyOf":[{"type":"object","title":"Responsepagination","properties":{"current":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"ads_results":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responseadsresultitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tags","default":null},"alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alias","default":null},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"button":{"anyOf":[{"type":"object","title":"Responseadsresultitembutton","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}},{"type":"null"}],"default":null},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"actions":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responseadsresultitemactionitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}}},{"type":"null"}],"title":"Actions","default":null},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null},"features":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Features","default":null},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null},"categories":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responseadsresultitemcategorieitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}}},{"type":"null"}],"title":"Categories","default":null},"highlights":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Highlights","default":null},"reviews_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviews Link","default":null},"neighborhoods":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Neighborhoods","default":null},"block_position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block Position","default":null},"service_options":{"anyOf":[{"type":"object","title":"Responseadsresultitemserviceoptions","properties":{"outdoor_dining":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Outdoor Dining","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}},{"type":"null"}],"default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Ads Results","default":null},"related_links":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responserelatedlinkitem","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Related Links","default":null},"organic_results":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responseorganicresultitem","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":null},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"alias":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alias","default":null},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":null},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price","default":null},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null},"rating":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rating","default":null},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","default":null},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":null},"reviews":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reviews","default":null},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null},"place_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Id","default":null},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":null},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":null},"categories":{"anyOf":[{"type":"array","items":{"type":"object","title":"Responseorganicresultitemcategorieitem","properties":{"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link","default":null},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}}},{"type":"null"}],"title":"Categories","default":null},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","default":null},"reviews_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviews Link","default":null},"neighborhoods":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Neighborhoods","default":null},"gps_coordinates":{"anyOf":[{"type":"object","title":"Responseorganicresultitemgpscoordinates","properties":{"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude","default":null},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude","default":null}},"additionalProperties":{"$ref":"#/components/schemas/sds_oiSNnl6piiW-6PsH3jP5d_72fdf45dc7359997_ref1"}},{"type":"null"}],"default":null}},"additionalProperties":{}}},{"type":"null"}],"title":"Organic Results","default":null},"search_metadata":{"anyOf":[{"type":"object","title":"Responsesearchmetadata","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","default":null},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":null},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At","default":null},"processed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Processed At","default":null},"json_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Json Endpoint","default":null},"total_time_taken":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Time Taken","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_parameters":{"anyOf":[{"type":"object","title":"Responsesearchparameters","properties":{"cflt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cflt","default":null},"attrs":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attrs","default":null},"start":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start","default":null},"sortby":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sortby","default":null},"find_loc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Find Loc","default":null},"find_desc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Find Desc","default":null},"yelp_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Yelp Domain","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"search_information":{"anyOf":[{"type":"object","title":"Responsesearchinformation","properties":{"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","default":null},"location":{"anyOf":[{"type":"object","title":"Responsesearchinformationlocation","properties":{"display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"page_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Title","default":null},"start_result":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Start Result","default":null},"total_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Results","default":null},"provider_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Domain","default":null},"results_per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Results Per Page","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"litescrape_pagination":{"anyOf":[{"type":"object","title":"Responselitescrapepagination","properties":{"next":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next","default":null}},"additionalProperties":{}},{"type":"null"}],"default":null},"submit_feedback_for_this_response_here":{"type":"string","format":"uri","readOnly":true,"description":"Optional feedback URL when present in an HTTP 200 tool response. Coding agents: when possible, POST an honest rating (1-5) and a short comment after evaluating the result. Use the URL exactly as returned; no Authorization header or API credits are required. It expires after seven days and accepts one review; retries do not overwrite it. Feedback is voluntary and stored separately from scraper data. Do not include secrets, personal data, or the full request/response. Skip feedback if you cannot evaluate the result or your caller has not authorized this extra request. Never submit feedback about feedback."}},"additionalProperties":{}},"example":null,"exampleRequest":null,"tags":["search","scraping"],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DHz4oBza8UBdWF5XyxJwR","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-x402","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Searches Yelp for businesses by location and optional query terms, returning structured listings with ratings, reviews, categories, pricing, and contact info.","exampleAgentPrompt":"Can you find me the top-rated sushi restaurants in San Francisco sorted by rating, and show me their addresses and phone numbers?","exampleUseCases":[{"title":"Find open restaurants for dinner tonight","prompt":"Search Yelp for Italian restaurants in Brooklyn that are open now, sorted by rating — I want the name, address, price level, and phone number for each one."},{"title":"Discover local coffee shops by category","prompt":"Look up coffee shops in Austin, Texas on Yelp using the category identifier 'coffee', sorted by review count, and give me the first 10 results with their ratings and addresses."},{"title":"Find budget-friendly options in a neighborhood","prompt":"Can you search Yelp for cheap eats — price level 1 — in the Mission District of San Francisco? I want businesses sorted by recommended and include their Yelp place_id so I can pull reviews later."}],"resultDescription":"Returns an array of organic_results, each containing position, business name, star rating, review count, categories, price tier, street address, phone number, and a place_id usable with the Yelp reviews endpoint. Also includes search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and a pagination object with a next-page URL or token when more results are available.","failureModes":["Missing required find_loc parameter returns a 400 error with error_code and error message","Invalid cflt category identifier returns empty results or an error","Invalid attrs filter names return an error or are silently ignored","Exceeding the start offset maximum of 10000 returns an error","Providing an unsupported yelp_domain may return an error or unexpected results","Rate limits or upstream Yelp availability issues return a retryable error response"],"whenToPreferThis":"Use this endpoint when you need structured Yelp business listings — including ratings, review counts, categories, price, address, and phone — for a specific location. It is ideal when Yelp-specific data (place_ids for reviews, Yelp attributes like open_now, price filters) is required, or when you need paginated results across many businesses. Prefer it over Google Maps or other local search endpoints when Yelp's crowd-sourced review data and category taxonomy are specifically needed, or when the user explicitly references Yelp.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-21T18:44:30.541Z","lastSuccessfullyRanAt":"2026-09-21T18:44:30.541Z","lastHealthCheckAt":"2026-11-03T18:40:20.942Z","isFirstParty":false,"canonicalSlug":"agents-litescrape-com-search-yelp-businesses-941e86b4"}