# Social Fetch API - Yelp endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

4 documented Yelp operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/yelp/businesses/search
Search Yelp businesses
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/yelp/businesses/search/get.mdx
SDK: client.yelp.searchBusinesses({ query: "guitar lessons", location: "New York, NY" })
Parameters:
- query (required, string) - Business name, service, or category to search for.
- location (required, string) - City, neighbourhood, postcode or address to search near.
- page (optional, integer) - Page number, starting at 1. Each page has up to 10 businesses.
- sort (optional, string, enum: recommended | highest_rated | most_reviewed) - Result order. `recommended` is Yelp's default ranking. `highest_rated` and `most_reviewed` use Yelp's own sorts.
Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/yelp/businesses/search?query=coffee shops&location=San Francisco, CA" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/yelp/businesses/{alias}
Get Yelp business details
Credit cost: 2 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/yelp/businesses/alias/get.mdx
SDK: client.yelp.getBusiness(alias)
Parameters:
- alias (required, string) - Yelp business alias or full business URL.
curl "https://api.socialfetch.dev/v1/yelp/businesses/gary-danko-san-francisco" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/yelp/businesses/{alias}/reviews
List Yelp business reviews
Credit cost: 2 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/yelp/businesses/alias/reviews/get.mdx
SDK: client.yelp.getReviews("business-alias", { category: "recommended" })
Parameters:
- alias (required, string) - Yelp business alias or full business URL.
- category (required, string, enum: recommended | not_recommended | removed) - Review category to return.
- cursor (optional, string) - Cursor returned with the previous page.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/yelp/businesses/gary-danko-san-francisco/reviews?category=recommended" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/yelp/businesses/{alias}/photos
List Yelp business photos
Credit cost: 2 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/yelp/businesses/alias/photos/get.mdx
SDK: client.yelp.getPhotos(alias)
Parameters:
- alias (required, string) - Yelp business alias or full business URL.
- cursor (optional, string) - Cursor returned with the previous page.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/yelp/businesses/gary-danko-san-francisco/photos" \
  -H "x-api-key: YOUR_API_KEY"