{"uid":"cap_VHF5pjhxCbX-PubtPxGWW","slug":"agents-litescrape-com-search-yelp-businesses-941e86b4","name":"Search Yelp Businesses","description":"Searches Yelp for businesses in find_loc, optionally matching find_desc terms or a cflt category, and returns organic_results (position, name, rating, review count, categories, price, address, phone, and the place_id for the reviews endpoint) with pagination. Sort with sortby, filter with Yelp attribute names in attrs, restrict to a map area with a Yelp l token, and use a localized yelp_domain for other countries. One call is one request.","url":"https://agents.litescrape.com/api/yelp/search","method":"GET","headers":{},"bodySchema":{"type":"object","required":["find_loc"],"properties":{"l":{"type":"string","description":"Yelp-native map bounds token."},"cflt":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","description":"Yelp category identifier, such as coffee or restaurants."},"attrs":{"type":"string","description":"Comma-separated Yelp attribute filters, such as open_now or price.1."},"start":{"type":"integer","default":0,"maximum":10000,"minimum":0,"description":"Result offset."},"sortby":{"enum":["recommended","rating","review_count"],"type":"string","default":"recommended","description":"Result order."},"find_loc":{"type":"string","description":"Search location, such as a city or neighborhood."},"find_desc":{"type":"string","description":"Business name, category, or search terms."},"yelp_domain":{"type":"string","default":"www.yelp.com","description":"Localized Yelp hostname, such as www.yelp.co.uk."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"organic_results":{"type":"array","items":{"type":"object"},"description":"Businesses: position, name, rating, review count, categories, price, address, phone, place_id."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"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-mpp","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":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:32.462Z","isFirstParty":false}