Yelp

List Yelp business photos

List public photos for a Yelp business.

GET/v1/yelp/businesses/{alias}/photos
2credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
aliasstringrequiredpath

Yelp business alias or full business URL.

min 2 chars · max 2048 chars

cursorstringoptionalquery

Cursor returned with the previous page.

min 1 chars · max 2048 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
22

Endpoint-specific response payload.

dataalias
string

Business alias from its Yelp URL.

min 2 chars · max 200 chars

databusinessId
string
databusinessName
string
dataphotos[]photoId
string
dataphotos[]url
string
dataphotos[]thumbnail
stringnullable
dataphotos[]caption
stringnullable
dataphotos[]width
integernullable

≥ 0

dataphotos[]height
integernullable

≥ 0

dataphotos[]uploadedAt
stringnullable
datasourceMediaCount
integer

Total media positions reported by Yelp for this business, including videos. This is not a count of photos returned in this response.

≥ 0

dataisTruncated
boolean

True when Yelp reports more media positions than those in this response. Request subsequent pages using page.nextCursor.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/yelp/businesses/gary-danko-san-francisco/photos" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yelp business photos.