Returns one page of up to ten organic businesses in Yelp’s ranking, sponsored listings in ads,
Yelp’s filter options for the search and pagination metadata.Credits: 15 per page with results. Empty searches, failed requests and cache hits (X-Cache: HIT)
are unbilled.location is required (at most 128 characters). page is 1 to 11. features and price are
comma lists; every filter must be applied by Yelp or the request returns 422 filter_not_applied.
query_matched: false means Yelp could not place the query: it shows either its broader ranking
(billed) or its own no-results page (results: [], free).
Invalid, unsupported or malformed parameters received by the API gateway return 422.
Ingress parsing happens first: a bare ; separates parameters, so location=SF;page=2 can
perform a billed page-2 search. Use & between parameters and %3B for a semicolon inside a
value; see the query encoding notes.
A location Yelp cannot find returns
400 invalid_location. Unavailable source content returns 503 instead of a billable empty result.
A key without the yelp scope returns 403.See the overview for markets, filters, fields and pagination.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ScrapeBadger","colors":{"primary":"#16A34A","light":"#22C55E","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3","dark":"https://mintcdn.com/scrapebadger/pHswKIBb9VFWmUQY/logo/dark.png?fit=max\u0026auto=format\u0026n=pHswKIBb9VFWmUQY\u0026q=85\u0026s=a5c2b0f2229bc45c6de7fb33b2318941"},"favicon":"https://mintcdn.com/scrapebadger/q5UXhzQrMbsIglQS/favicon.png?fit=max\u0026auto=format\u0026n=q5UXhzQrMbsIglQS\u0026q=85\u0026s=cf0ec94b52375fd84ae198f26e812030","api":{"openapi":["https://scrapebadger.com/api/twitter-openapi.json","openapi-web-scraping.json","openapi-vinted.json","openapi-amazon.json","openapi-ebay.json","openapi-realtor.json","openapi-zillow.json","openapi-tiktok.json","openapi-reddit.json","openapi-google.json","openapi-account.json","openapi-github.json","openapi-autoscout24.json","openapi-brave.json","openapi-yelp.json"],"playground":{}},"navbar":{"links":[{"href":"mailto:support@scrapebadger.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"}},"footer":{"socials":{"x":"https://x.com/scrapebadger","github":"https://github.com/scrape-badger"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scrapebadger","hasAudioNarration":false,"actualSubdomain":"scrapebadger","customDomains":["docs.scrapebadger.com"],"gitSource":{"type":"github","owner":"scrape-badger","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aef959bd5518ba96e46ce58","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Search","count":71},{"language":"default","tag":"Twitter","count":62},{"language":"default","tag":"Naver","count":56},{"language":"default","tag":"Google","count":50},{"language":"default","tag":"Overview","count":42},{"language":"default","tag":"Endpoints","count":39},{"language":"default","tag":"Reference","count":38},{"language":"default","tag":"TikTok","count":36},{"language":"default","tag":"Users","count":29},{"language":"default","tag":"Getting Started","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs{min-width:0;overflow-x:auto;overscroll-behavior-x:contain;scrollbar-width:thin}.nav-tabs-item{flex-shrink:0;white-space:nowrap}"}],"page":{"pagePath":"api-reference/endpoint/yelp/search","slug":"/api-reference/endpoint/yelp/search","pageMetadata":{"title":"Search businesses","openapi":"GET /v1/yelp/search","description":"Ranked Yelp businesses for a location, with ads kept separate.","href":"/api-reference/endpoint/yelp/search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Ranked Yelp businesses for a location, with ads kept separate.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns one page of up to ten organic businesses in Yelp’s ranking, sponsored listings in `,_jsx(_components.code,{children:`ads`}),`,\nYelp’s filter options for the search and pagination metadata.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Credits:`}),` 15 per page with results. Empty searches, failed requests and cache hits (`,_jsx(_components.code,{children:`X-Cache: HIT`}),`)\nare unbilled.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`location`}),` is required (at most 128 characters). `,_jsx(_components.code,{children:`page`}),` is 1 to 11. `,_jsx(_components.code,{children:`features`}),` and `,_jsx(_components.code,{children:`price`}),` are\ncomma lists; every filter must be applied by Yelp or the request returns `,_jsx(_components.code,{children:`422 filter_not_applied`}),`.\n`,_jsx(_components.code,{children:`query_matched: false`}),` means Yelp could not place the query: it shows either its broader ranking\n(billed) or its own no-results page (`,_jsx(_components.code,{children:`results: []`}),`, free).`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Invalid, unsupported or malformed parameters received by the API gateway return `,_jsx(_components.code,{children:`422`}),`.\nIngress parsing happens first: a bare `,_jsx(_components.code,{children:`;`}),` separates parameters, so `,_jsx(_components.code,{children:`location=SF;page=2`}),` can\nperform a billed page-2 search. Use `,_jsx(_components.code,{children:`\u0026`}),` between parameters and `,_jsx(_components.code,{children:`%3B`}),` for a semicolon inside a\nvalue; see the `,_jsx(_components.a,{href:`/yelp/overview#filters-and-sorting`,children:`query encoding notes`}),`.\nA location Yelp cannot find returns\n`,_jsx(_components.code,{children:`400 invalid_location`}),`. Unavailable source content returns `,_jsx(_components.code,{children:`503`}),` instead of a billable empty result.\nA key without the `,_jsx(_components.code,{children:`yelp`}),` scope returns `,_jsx(_components.code,{children:`403`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/yelp/overview`,children:`overview`}),` for markets, filters, fields and pagination.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search businesses","openapi":"GET /v1/yelp/search","description":"Ranked Yelp businesses for a location, with ads kept separate.","href":"/api-reference/endpoint/yelp/search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Yelp"],"summary":"Search businesses","description":"Ranked Yelp businesses for a location, with ads kept separate.","operationId":"yelp_search_businesses","parameters":["76c6ef94-1cd5-429f-b703-4b2e85f091c1","ee67428b-c2af-472b-adde-cebc29906c40","fe588819-a43f-46fc-9743-de742885c070","d00b383d-e505-402d-8ada-9108dc4bec65","ec278174-eab0-47e7-a073-e91b118b3087","50464de4-f7d1-4fab-94f4-fee172d3bc38","1531825a-977e-4a45-b4e5-4f81382e73d6","0bb532ef-e71c-4707-804d-b268f525e92a"],"responses":{"200":"a352463a-d3d6-4e5f-b00c-b2d5b585d40d","422":"65f4fe67-c9c4-4dbf-bdbf-d483be4139e6"},"security":["778cc2c9-006f-40fe-9cc1-c315c0092393"],"x-availability":"active","method":"get","type":"path","servers":["50f8114f-6de9-4c70-b926-18726a85f226"],"path":"/v1/yelp/search","baseUrlOptions":["https://scrapebadger.com"],"title":"Search businesses","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"76c6ef94-1cd5-429f-b703-4b2e85f091c1":{"name":"location","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"description":"Where to search, as typed into Yelp: city, neighbourhood, address or postcode.","title":"Location","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"Where to search, as typed into Yelp: city, neighbourhood, address or postcode."},"ee67428b-c2af-472b-adde-cebc29906c40":{"name":"query","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Query","description":"What to search for (e.g. pizza, plumbers). Optional when category is set.","maxLength":128,"uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Query","description":"What to search for (e.g. pizza, plumbers). Optional when category is set.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"What to search for (e.g. pizza, plumbers). Optional when category is set."},"fe588819-a43f-46fc-9743-de742885c070":{"name":"market","in":"query","required":false,"schema":{"enum":["us","ca"],"type":"string","description":"Yelp site to search; see /markets.","default":"us","title":"Market","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Yelp site to search; see /markets."},"d00b383d-e505-402d-8ada-9108dc4bec65":{"name":"category","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Category","description":"Yelp category alias, e.g. pizza, coffee, plumbing.","pattern":"^[a-z0-9_-]{1,64}$","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Category","description":"Yelp category alias, e.g. pizza, coffee, plumbing.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Yelp category alias, e.g. pizza, coffee, plumbing."},"ec278174-eab0-47e7-a073-e91b118b3087":{"name":"sort_by","in":"query","required":false,"schema":{"enum":["recommended","rating","review_count"],"type":"string","default":"recommended","title":"Sort By","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"50464de4-f7d1-4fab-94f4-fee172d3bc38":{"name":"price","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Price","description":"Comma-separated price levels 1-4 ($ to $$$$).","pattern":"^[1-4](,[1-4]){0,3}$","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Price","description":"Comma-separated price levels 1-4 ($ to $$$$).","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Comma-separated price levels 1-4 ($ to $$$$)."},"1531825a-977e-4a45-b4e5-4f81382e73d6":{"name":"features","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Features","description":"Comma-separated refinements: delivery, takeout, reservations, outdoor_seating, good_for_kids, dogs_allowed, free_wifi, wheelchair_accessible.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Features","description":"Comma-separated refinements: delivery, takeout, reservations, outdoor_seating, good_for_kids, dogs_allowed, free_wifi, wheelchair_accessible.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Comma-separated refinements: delivery, takeout, reservations, outdoor_seating, good_for_kids, dogs_allowed, free_wifi, wheelchair_accessible."},"0bb532ef-e71c-4707-804d-b268f525e92a":{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":11,"minimum":1,"description":"1-based page, ten businesses each; pages 1-11.","default":1,"title":"Page","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"1-based page, ten businesses each; pages 1-11."}},"responses":{"a352463a-d3d6-4e5f-b00c-b2d5b585d40d":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"market":{"type":"string","title":"Market","isRequired":true,"uniqueKey":"market","typeLabel":"string"},"query":{"oneOf":[{"type":"string","title":"Query","isRequired":true,"uniqueKey":"query.oneOf.0","typeLabel":"string"},{"type":"null","title":"Query","isRequired":true,"uniqueKey":"query.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"query","typeLabel":"string | null"},"location":{"type":"string","title":"Location","isRequired":true,"uniqueKey":"location","typeLabel":"string"},"location_resolved":{"properties":{"city":{"oneOf":[{"type":"string","title":"City","uniqueKey":"location_resolved.city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"location_resolved.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"location_resolved.city","typeLabel":"string | null"},"state":{"oneOf":[{"type":"string","title":"State","uniqueKey":"location_resolved.state.oneOf.0","typeLabel":"string"},{"type":"null","title":"State","uniqueKey":"location_resolved.state.oneOf.1","typeLabel":"null"}],"uniqueKey":"location_resolved.state","typeLabel":"string | null"},"country":{"oneOf":[{"type":"string","title":"Country","uniqueKey":"location_resolved.country.oneOf.0","typeLabel":"string"},{"type":"null","title":"Country","uniqueKey":"location_resolved.country.oneOf.1","typeLabel":"null"}],"uniqueKey":"location_resolved.country","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","title":"Latitude","description":"Search centre, not a business.","uniqueKey":"location_resolved.latitude.oneOf.0","typeLabel":"number"},{"type":"null","title":"Latitude","description":"Search centre, not a business.","uniqueKey":"location_resolved.latitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"location_resolved.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","title":"Longitude","uniqueKey":"location_resolved.longitude.oneOf.0","typeLabel":"number"},{"type":"null","title":"Longitude","uniqueKey":"location_resolved.longitude.oneOf.1","typeLabel":"null"}],"uniqueKey":"location_resolved.longitude","typeLabel":"number | null"}},"additionalProperties":true,"type":"object","title":"YelpResolvedLocation","isRequired":true,"uniqueKey":"location_resolved","typeLabel":"YelpResolvedLocation · object"},"query_matched":{"type":"boolean","title":"Query Matched","description":"False when Yelp could not place the query; results are then Yelp's broader ranking for the location, as Yelp shows them.","isRequired":true,"uniqueKey":"query_matched","typeLabel":"boolean"},"total_results":{"type":"integer","title":"Total Results","description":"Yelp's reported total; at most 110 are browsable.","isRequired":true,"uniqueKey":"total_results","typeLabel":"integer"},"page":{"type":"integer","title":"Page","isRequired":true,"uniqueKey":"page","typeLabel":"integer"},"page_size":{"type":"integer","title":"Page Size","isRequired":true,"uniqueKey":"page_size","typeLabel":"integer"},"total_pages":{"type":"integer","title":"Total Pages","isRequired":true,"uniqueKey":"total_pages","typeLabel":"integer"},"has_next_page":{"type":"boolean","title":"Has Next Page","isRequired":true,"uniqueKey":"has_next_page","typeLabel":"boolean"},"results":{"items":{"properties":{"position":{"type":"integer","title":"Position","description":"1-based place in Yelp's organic order across pages (page 2 starts at 11): Yelp's own number where it numbers the results; services searches are unnumbered and keep Yelp's order. For ads, the slot order.","isRequired":true,"uniqueKey":"results.items.[INDEX].position","typeLabel":"integer"},"is_ad":{"type":"boolean","title":"Is Ad","isRequired":true,"uniqueKey":"results.items.[INDEX].is_ad","typeLabel":"boolean"},"id":{"type":"string","title":"Id","description":"Yelp encrypted business ID.","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string"},"alias":{"type":"string","title":"Alias","description":"Business slug used in /biz/\u003calias>.","isRequired":true,"uniqueKey":"results.items.[INDEX].alias","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"results.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","title":"Url","isRequired":true,"uniqueKey":"results.items.[INDEX].url","typeLabel":"string"},"rating":{"oneOf":[{"type":"number","title":"Rating","uniqueKey":"results.items.[INDEX].rating.oneOf.0","typeLabel":"number"},{"type":"null","title":"Rating","uniqueKey":"results.items.[INDEX].rating.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].rating","typeLabel":"number | null"},"review_count":{"oneOf":[{"type":"integer","title":"Review Count","uniqueKey":"results.items.[INDEX].review_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Review Count","uniqueKey":"results.items.[INDEX].review_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].review_count","typeLabel":"integer | null"},"price":{"oneOf":[{"type":"string","title":"Price","description":"Price symbols as shown, e.g. $$.","uniqueKey":"results.items.[INDEX].price.oneOf.0","typeLabel":"string"},{"type":"null","title":"Price","description":"Price symbols as shown, e.g. $$.","uniqueKey":"results.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price","typeLabel":"string | null"},"price_level":{"oneOf":[{"type":"integer","title":"Price Level","uniqueKey":"results.items.[INDEX].price_level.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Price Level","uniqueKey":"results.items.[INDEX].price_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].price_level","typeLabel":"integer | null"},"categories":{"items":{"properties":{"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"results.items.[INDEX].categories.items.[INDEX].title","typeLabel":"string"},"alias":{"oneOf":[{"type":"string","title":"Alias","uniqueKey":"results.items.[INDEX].categories.items.[INDEX].alias.oneOf.0","typeLabel":"string"},{"type":"null","title":"Alias","uniqueKey":"results.items.[INDEX].categories.items.[INDEX].alias.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].categories.items.[INDEX].alias","typeLabel":"string | null"}},"additionalProperties":true,"type":"object","required":["title"],"title":"YelpCategory","uniqueKey":"results.items.[INDEX].categories.items.[INDEX]","typeLabel":"YelpCategory · object"},"type":"array","title":"Categories","uniqueKey":"results.items.[INDEX].categories","typeLabel":"YelpCategory · object[]"},"neighborhoods":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].neighborhoods.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Neighborhoods","uniqueKey":"results.items.[INDEX].neighborhoods","typeLabel":"string[]"},"address":{"oneOf":[{"type":"string","title":"Address","description":"Street line as shown on the card.","uniqueKey":"results.items.[INDEX].address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Address","description":"Street line as shown on the card.","uniqueKey":"results.items.[INDEX].address.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","uniqueKey":"results.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"results.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].city","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","title":"Phone","description":"Shown on sponsored cards only.","uniqueKey":"results.items.[INDEX].phone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Phone","description":"Shown on sponsored cards only.","uniqueKey":"results.items.[INDEX].phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].phone","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","title":"Timezone","uniqueKey":"results.items.[INDEX].timezone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Timezone","uniqueKey":"results.items.[INDEX].timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].timezone","typeLabel":"string | null"},"opening_hours":{"items":{"properties":{"day":{"type":"string","title":"Day","isRequired":true,"uniqueKey":"results.items.[INDEX].opening_hours.items.[INDEX].day","typeLabel":"string"},"open":{"type":"string","title":"Open","description":"Local wall time HH:MM.","isRequired":true,"uniqueKey":"results.items.[INDEX].opening_hours.items.[INDEX].open","typeLabel":"string"},"close":{"type":"string","title":"Close","description":"Local wall time HH:MM; may be past midnight.","isRequired":true,"uniqueKey":"results.items.[INDEX].opening_hours.items.[INDEX].close","typeLabel":"string"}},"additionalProperties":true,"type":"object","required":["day","open","close"],"title":"YelpHours","uniqueKey":"results.items.[INDEX].opening_hours.items.[INDEX]","typeLabel":"YelpHours · object"},"type":"array","title":"Opening Hours","uniqueKey":"results.items.[INDEX].opening_hours","typeLabel":"YelpHours · object[]"},"snippet":{"oneOf":[{"type":"string","title":"Snippet","description":"Short excerpt, not a full review.","uniqueKey":"results.items.[INDEX].snippet.oneOf.0","typeLabel":"string"},{"type":"null","title":"Snippet","description":"Short excerpt, not a full review.","uniqueKey":"results.items.[INDEX].snippet.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].snippet","typeLabel":"string | null"},"snippet_type":{"oneOf":[{"type":"string","title":"Snippet Type","uniqueKey":"results.items.[INDEX].snippet_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Snippet Type","uniqueKey":"results.items.[INDEX].snippet_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].snippet_type","typeLabel":"string | null"},"highlights":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].highlights.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Highlights","uniqueKey":"results.items.[INDEX].highlights","typeLabel":"string[]"},"tags":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Tags","uniqueKey":"results.items.[INDEX].tags","typeLabel":"string[]"},"photos":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].photos.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Photos","uniqueKey":"results.items.[INDEX].photos","typeLabel":"string[]"},"alternate_names":{"items":{"type":"string","uniqueKey":"results.items.[INDEX].alternate_names.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Alternate Names","uniqueKey":"results.items.[INDEX].alternate_names","typeLabel":"string[]"},"is_service_area_business":{"oneOf":[{"type":"boolean","title":"Is Service Area Business","uniqueKey":"results.items.[INDEX].is_service_area_business.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Service Area Business","uniqueKey":"results.items.[INDEX].is_service_area_business.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_service_area_business","typeLabel":"boolean | null"},"is_yelp_guaranteed":{"oneOf":[{"type":"boolean","title":"Is Yelp Guaranteed","uniqueKey":"results.items.[INDEX].is_yelp_guaranteed.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Yelp Guaranteed","uniqueKey":"results.items.[INDEX].is_yelp_guaranteed.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].is_yelp_guaranteed","typeLabel":"boolean | null"},"has_verified_license":{"oneOf":[{"type":"boolean","title":"Has Verified License","uniqueKey":"results.items.[INDEX].has_verified_license.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Has Verified License","uniqueKey":"results.items.[INDEX].has_verified_license.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].has_verified_license","typeLabel":"boolean | null"},"ad_placement":{"oneOf":[{"type":"string","title":"Ad Placement","description":"Ads only: Yelp's ad slot.","uniqueKey":"results.items.[INDEX].ad_placement.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ad Placement","description":"Ads only: Yelp's ad slot.","uniqueKey":"results.items.[INDEX].ad_placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].ad_placement","typeLabel":"string | null"}},"additionalProperties":true,"type":"object","required":["position","is_ad","id","alias","name","url"],"title":"YelpBusiness","description":"A business card as ranked on the search page; nullable fields are absent from some cards.","uniqueKey":"results.items.[INDEX]","typeLabel":"YelpBusiness · object"},"type":"array","title":"Results","isRequired":true,"uniqueKey":"results","typeLabel":"YelpBusiness · object[]"},"ads":{"items":{"properties":{"position":{"type":"integer","title":"Position","description":"1-based place in Yelp's organic order across pages (page 2 starts at 11): Yelp's own number where it numbers the results; services searches are unnumbered and keep Yelp's order. For ads, the slot order.","isRequired":true,"uniqueKey":"ads.items.[INDEX].position","typeLabel":"integer"},"is_ad":{"type":"boolean","title":"Is Ad","isRequired":true,"uniqueKey":"ads.items.[INDEX].is_ad","typeLabel":"boolean"},"id":{"type":"string","title":"Id","description":"Yelp encrypted business ID.","isRequired":true,"uniqueKey":"ads.items.[INDEX].id","typeLabel":"string"},"alias":{"type":"string","title":"Alias","description":"Business slug used in /biz/\u003calias>.","isRequired":true,"uniqueKey":"ads.items.[INDEX].alias","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"ads.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","title":"Url","isRequired":true,"uniqueKey":"ads.items.[INDEX].url","typeLabel":"string"},"rating":{"oneOf":[{"type":"number","title":"Rating","uniqueKey":"ads.items.[INDEX].rating.oneOf.0","typeLabel":"number"},{"type":"null","title":"Rating","uniqueKey":"ads.items.[INDEX].rating.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].rating","typeLabel":"number | null"},"review_count":{"oneOf":[{"type":"integer","title":"Review Count","uniqueKey":"ads.items.[INDEX].review_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Review Count","uniqueKey":"ads.items.[INDEX].review_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].review_count","typeLabel":"integer | null"},"price":{"oneOf":[{"type":"string","title":"Price","description":"Price symbols as shown, e.g. $$.","uniqueKey":"ads.items.[INDEX].price.oneOf.0","typeLabel":"string"},{"type":"null","title":"Price","description":"Price symbols as shown, e.g. $$.","uniqueKey":"ads.items.[INDEX].price.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].price","typeLabel":"string | null"},"price_level":{"oneOf":[{"type":"integer","title":"Price Level","uniqueKey":"ads.items.[INDEX].price_level.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Price Level","uniqueKey":"ads.items.[INDEX].price_level.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].price_level","typeLabel":"integer | null"},"categories":{"items":{"properties":{"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"ads.items.[INDEX].categories.items.[INDEX].title","typeLabel":"string"},"alias":{"oneOf":[{"type":"string","title":"Alias","uniqueKey":"ads.items.[INDEX].categories.items.[INDEX].alias.oneOf.0","typeLabel":"string"},{"type":"null","title":"Alias","uniqueKey":"ads.items.[INDEX].categories.items.[INDEX].alias.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].categories.items.[INDEX].alias","typeLabel":"string | null"}},"additionalProperties":true,"type":"object","required":["title"],"title":"YelpCategory","uniqueKey":"ads.items.[INDEX].categories.items.[INDEX]","typeLabel":"YelpCategory · object"},"type":"array","title":"Categories","uniqueKey":"ads.items.[INDEX].categories","typeLabel":"YelpCategory · object[]"},"neighborhoods":{"items":{"type":"string","uniqueKey":"ads.items.[INDEX].neighborhoods.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Neighborhoods","uniqueKey":"ads.items.[INDEX].neighborhoods","typeLabel":"string[]"},"address":{"oneOf":[{"type":"string","title":"Address","description":"Street line as shown on the card.","uniqueKey":"ads.items.[INDEX].address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Address","description":"Street line as shown on the card.","uniqueKey":"ads.items.[INDEX].address.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].address","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","title":"City","uniqueKey":"ads.items.[INDEX].city.oneOf.0","typeLabel":"string"},{"type":"null","title":"City","uniqueKey":"ads.items.[INDEX].city.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].city","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","title":"Phone","description":"Shown on sponsored cards only.","uniqueKey":"ads.items.[INDEX].phone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Phone","description":"Shown on sponsored cards only.","uniqueKey":"ads.items.[INDEX].phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].phone","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","title":"Timezone","uniqueKey":"ads.items.[INDEX].timezone.oneOf.0","typeLabel":"string"},{"type":"null","title":"Timezone","uniqueKey":"ads.items.[INDEX].timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].timezone","typeLabel":"string | null"},"opening_hours":{"items":{"properties":{"day":{"type":"string","title":"Day","isRequired":true,"uniqueKey":"ads.items.[INDEX].opening_hours.items.[INDEX].day","typeLabel":"string"},"open":{"type":"string","title":"Open","description":"Local wall time HH:MM.","isRequired":true,"uniqueKey":"ads.items.[INDEX].opening_hours.items.[INDEX].open","typeLabel":"string"},"close":{"type":"string","title":"Close","description":"Local wall time HH:MM; may be past midnight.","isRequired":true,"uniqueKey":"ads.items.[INDEX].opening_hours.items.[INDEX].close","typeLabel":"string"}},"additionalProperties":true,"type":"object","required":["day","open","close"],"title":"YelpHours","uniqueKey":"ads.items.[INDEX].opening_hours.items.[INDEX]","typeLabel":"YelpHours · object"},"type":"array","title":"Opening Hours","uniqueKey":"ads.items.[INDEX].opening_hours","typeLabel":"YelpHours · object[]"},"snippet":{"oneOf":[{"type":"string","title":"Snippet","description":"Short excerpt, not a full review.","uniqueKey":"ads.items.[INDEX].snippet.oneOf.0","typeLabel":"string"},{"type":"null","title":"Snippet","description":"Short excerpt, not a full review.","uniqueKey":"ads.items.[INDEX].snippet.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].snippet","typeLabel":"string | null"},"snippet_type":{"oneOf":[{"type":"string","title":"Snippet Type","uniqueKey":"ads.items.[INDEX].snippet_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Snippet Type","uniqueKey":"ads.items.[INDEX].snippet_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].snippet_type","typeLabel":"string | null"},"highlights":{"items":{"type":"string","uniqueKey":"ads.items.[INDEX].highlights.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Highlights","uniqueKey":"ads.items.[INDEX].highlights","typeLabel":"string[]"},"tags":{"items":{"type":"string","uniqueKey":"ads.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Tags","uniqueKey":"ads.items.[INDEX].tags","typeLabel":"string[]"},"photos":{"items":{"type":"string","uniqueKey":"ads.items.[INDEX].photos.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Photos","uniqueKey":"ads.items.[INDEX].photos","typeLabel":"string[]"},"alternate_names":{"items":{"type":"string","uniqueKey":"ads.items.[INDEX].alternate_names.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Alternate Names","uniqueKey":"ads.items.[INDEX].alternate_names","typeLabel":"string[]"},"is_service_area_business":{"oneOf":[{"type":"boolean","title":"Is Service Area Business","uniqueKey":"ads.items.[INDEX].is_service_area_business.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Service Area Business","uniqueKey":"ads.items.[INDEX].is_service_area_business.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].is_service_area_business","typeLabel":"boolean | null"},"is_yelp_guaranteed":{"oneOf":[{"type":"boolean","title":"Is Yelp Guaranteed","uniqueKey":"ads.items.[INDEX].is_yelp_guaranteed.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Yelp Guaranteed","uniqueKey":"ads.items.[INDEX].is_yelp_guaranteed.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].is_yelp_guaranteed","typeLabel":"boolean | null"},"has_verified_license":{"oneOf":[{"type":"boolean","title":"Has Verified License","uniqueKey":"ads.items.[INDEX].has_verified_license.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Has Verified License","uniqueKey":"ads.items.[INDEX].has_verified_license.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].has_verified_license","typeLabel":"boolean | null"},"ad_placement":{"oneOf":[{"type":"string","title":"Ad Placement","description":"Ads only: Yelp's ad slot.","uniqueKey":"ads.items.[INDEX].ad_placement.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ad Placement","description":"Ads only: Yelp's ad slot.","uniqueKey":"ads.items.[INDEX].ad_placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"ads.items.[INDEX].ad_placement","typeLabel":"string | null"}},"additionalProperties":true,"type":"object","required":["position","is_ad","id","alias","name","url"],"title":"YelpBusiness","description":"A business card as ranked on the search page; nullable fields are absent from some cards.","uniqueKey":"ads.items.[INDEX]","typeLabel":"YelpBusiness · object"},"type":"array","title":"Ads","isRequired":true,"uniqueKey":"ads","typeLabel":"YelpBusiness · object[]"},"filters":{"additionalProperties":{"properties":{"title":{"type":"string","title":"Title","isRequired":true,"uniqueKey":"filters.additionalProperties.title","typeLabel":"string"},"type":{"type":"string","title":"Type","isRequired":true,"uniqueKey":"filters.additionalProperties.type","typeLabel":"string"},"options":{"items":{"properties":{"value":{"type":"string","title":"Value","isRequired":true,"uniqueKey":"filters.additionalProperties.options.items.[INDEX].value","typeLabel":"string"},"text":{"type":"string","title":"Text","isRequired":true,"uniqueKey":"filters.additionalProperties.options.items.[INDEX].text","typeLabel":"string"},"selected":{"type":"boolean","title":"Selected","isRequired":true,"uniqueKey":"filters.additionalProperties.options.items.[INDEX].selected","typeLabel":"boolean"}},"additionalProperties":true,"type":"object","required":["value","text","selected"],"title":"YelpFilterOption","uniqueKey":"filters.additionalProperties.options.items.[INDEX]","typeLabel":"YelpFilterOption · object"},"type":"array","title":"Options","isRequired":true,"uniqueKey":"filters.additionalProperties.options","typeLabel":"YelpFilterOption · object[]"}},"additionalProperties":true,"type":"object","required":["title","type","options"],"title":"YelpFilterGroup","uniqueKey":"filters.additionalProperties","typeLabel":"YelpFilterGroup · object"},"type":"object","title":"Filters","isRequired":true,"uniqueKey":"filters","typeLabel":"Filters · object"},"related_searches":{"items":{"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"related_searches.items.[INDEX].name","typeLabel":"string"},"url":{"type":"string","title":"Url","isRequired":true,"uniqueKey":"related_searches.items.[INDEX].url","typeLabel":"string"}},"additionalProperties":true,"type":"object","required":["name","url"],"title":"YelpLink","uniqueKey":"related_searches.items.[INDEX]","typeLabel":"YelpLink · object"},"type":"array","title":"Related Searches","isRequired":true,"uniqueKey":"related_searches","typeLabel":"YelpLink · object[]"},"source_url":{"type":"string","title":"Source Url","isRequired":true,"uniqueKey":"source_url","typeLabel":"string"},"fetched_at":{"type":"string","title":"Fetched At","isRequired":true,"uniqueKey":"fetched_at","typeLabel":"string"},"fetched_utc":{"type":"number","title":"Fetched Utc","isRequired":true,"uniqueKey":"fetched_utc","typeLabel":"number"},"did_you_mean":{"oneOf":[{"type":"string","title":"Did You Mean","uniqueKey":"did_you_mean.oneOf.0","typeLabel":"string"},{"type":"null","title":"Did You Mean","uniqueKey":"did_you_mean.oneOf.1","typeLabel":"null"}],"uniqueKey":"did_you_mean","typeLabel":"string | null"},"next_page":{"oneOf":[{"type":"integer","title":"Next Page","uniqueKey":"next_page.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Next Page","uniqueKey":"next_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_page","typeLabel":"integer | null"}},"additionalProperties":true,"type":"object","required":["market","query","location","location_resolved","query_matched","total_results","page","page_size","total_pages","has_next_page","results","ads","filters","related_searches","source_url","fetched_at","fetched_utc"],"title":"YelpSearchResponse","uniqueKey":"","typeLabel":"YelpSearchResponse · object"},"examples":{"Example":{"title":"Example","value":{"market":"\u003cstring>","query":"\u003cstring>","location":"\u003cstring>","location_resolved":{"city":"\u003cstring>","state":"\u003cstring>","country":"\u003cstring>","latitude":123,"longitude":123},"query_matched":true,"total_results":123,"page":123,"page_size":123,"total_pages":123,"has_next_page":true,"results":[{"position":123,"is_ad":true,"id":"\u003cstring>","alias":"\u003cstring>","name":"\u003cstring>","url":"\u003cstring>","rating":123,"review_count":123,"price":"\u003cstring>","price_level":123,"categories":[{"title":"\u003cstring>","alias":"\u003cstring>"}],"neighborhoods":["\u003cstring>"],"address":"\u003cstring>","city":"\u003cstring>","phone":"\u003cstring>","timezone":"\u003cstring>","opening_hours":[{"day":"\u003cstring>","open":"\u003cstring>","close":"\u003cstring>"}],"snippet":"\u003cstring>","snippet_type":"\u003cstring>","highlights":["\u003cstring>"],"tags":["\u003cstring>"],"photos":["\u003cstring>"],"alternate_names":["\u003cstring>"],"is_service_area_business":true,"is_yelp_guaranteed":true,"has_verified_license":true,"ad_placement":"\u003cstring>"}],"ads":[{"position":123,"is_ad":true,"id":"\u003cstring>","alias":"\u003cstring>","name":"\u003cstring>","url":"\u003cstring>","rating":123,"review_count":123,"price":"\u003cstring>","price_level":123,"categories":[{"title":"\u003cstring>","alias":"\u003cstring>"}],"neighborhoods":["\u003cstring>"],"address":"\u003cstring>","city":"\u003cstring>","phone":"\u003cstring>","timezone":"\u003cstring>","opening_hours":[{"day":"\u003cstring>","open":"\u003cstring>","close":"\u003cstring>"}],"snippet":"\u003cstring>","snippet_type":"\u003cstring>","highlights":["\u003cstring>"],"tags":["\u003cstring>"],"photos":["\u003cstring>"],"alternate_names":["\u003cstring>"],"is_service_area_business":true,"is_yelp_guaranteed":true,"has_verified_license":true,"ad_placement":"\u003cstring>"}],"filters":{},"related_searches":[{"name":"\u003cstring>","url":"\u003cstring>"}],"source_url":"\u003cstring>","fetched_at":"\u003cstring>","fetched_utc":123,"did_you_mean":"\u003cstring>","next_page":123}}},"exampleType":"generated"}},"exampleType":"generated"},"65f4fe67-c9c4-4dbf-bdbf-d483be4139e6":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"778cc2c9-006f-40fe-9cc1-c315c0092393":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"50f8114f-6de9-4c70-b926-18726a85f226":{"url":"https://scrapebadger.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi-yelp.json"},"subdomain":"scrapebadger","siteName":"ScrapeBadger","title":"Search businesses - ScrapeBadger","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T19:16:32.272Z","originalFileLocation":"api-reference/endpoint/yelp/search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Ranked Yelp businesses for a location, with ads kept separate.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search businesses - ScrapeBadger\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ranked Yelp businesses for a location, with ads kept separate.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Search+businesses\u0026amp;description=Ranked+Yelp+businesses+for+a+location%2C+with+ads+kept+separate.\u0026amp;theme=a8afda73f3529961ad914289\u0026amp;signature=9281543a5d2e1ba6c7318361c668fd966c871c2f02f6ba57f56e8c7768e1b659\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search businesses - ScrapeBadger\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ranked Yelp businesses for a location, with ads kept separate.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Search+businesses\u0026amp;description=Ranked+Yelp+businesses+for+a+location%2C+with+ads+kept+separate.\u0026amp;theme=a8afda73f3529961ad914289\u0026amp;signature=9281543a5d2e1ba6c7318361c668fd966c871c2f02f6ba57f56e8c7768e1b659\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/yelp/search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.scrapebadger.com/#organization\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.scrapebadger.com#website\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search#webpage\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search\",\"name\":\"Search businesses\",\"description\":\"Ranked Yelp businesses for a location, with ads kept separate.\",\"dateModified\":\"2026-11-07T19:16:32.272Z\",\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ScrapeBadger\",\"item\":\"https://docs.scrapebadger.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search businesses\",\"item\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search#apireference\",\"headline\":\"Search businesses\",\"name\":\"Search businesses\",\"description\":\"Ranked Yelp businesses for a location, with ads kept separate.\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/yelp/search#webpage\"},\"dateModified\":\"2026-11-07T19:16:32.272Z\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ScrapeBadger\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ScrapeBadger","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":""}]},{"tab":"Web Scraping","pages":[{"title":"Web Scraping","href":"/web-scraping/overview"}]},{"tab":"Google","pages":[{"title":"Google","href":"/google/overview"}]},{"tab":"Baidu","pages":[{"title":"Baidu","href":"/baidu/overview"}]},{"tab":"Bing","pages":[{"title":"Bing","href":"/bing/overview"}]},{"tab":"DuckDuckGo","pages":[{"title":"DuckDuckGo","href":"/duckduckgo/overview"}]},{"tab":"Yahoo","pages":[{"title":"Yahoo","href":"/yahoo/overview"}]},{"tab":"Yandex","pages":[{"title":"Yandex","href":"/yandex/overview"}]},{"tab":"Naver","pages":[{"title":"Naver","href":"/naver/overview"}]},{"tab":"Reddit","pages":[{"title":"Reddit","href":"/reddit/overview"}]},{"tab":"Vinted","pages":[{"title":"Vinted","href":"/vinted/overview"}]},{"tab":"Depop","pages":[{"title":"Depop","href":"/depop/overview"}]},{"tab":"Wallapop","pages":[{"title":"Wallapop","href":"/wallapop/overview"}]},{"tab":"LinkedIn","pages":[{"title":"LinkedIn","href":"/linkedin/overview"}]},{"tab":"Amazon","pages":[{"title":"Amazon","href":"/amazon/overview"}]},{"tab":"eBay","pages":[{"title":"eBay","href":"/ebay/overview"}]},{"tab":"Walmart","pages":[{"title":"Walmart","href":"/walmart/overview"}]},{"tab":"Google Play","pages":[{"title":"Google Play","href":"/google-play/overview"}]},{"tab":"App Store","pages":[{"title":"App Store","href":"/app-store/overview"}]},{"tab":"Leboncoin","pages":[{"title":"Leboncoin","href":"/leboncoin/overview"}]},{"tab":"Gumtree","pages":[{"title":"Gumtree","href":"/gumtree/overview"}]},{"tab":"Immobiliare","pages":[{"title":"Immobiliare","href":"/immobiliare/overview"}]},{"tab":"LoopNet","pages":[{"title":"LoopNet","href":"/loopnet/overview"}]},{"tab":"Airbnb","pages":[{"title":"Airbnb","href":"/airbnb/overview"}]},{"tab":"Booking.com","pages":[{"title":"Booking.com","href":"/booking/overview"}]},{"tab":"Apartments.com","pages":[{"title":"Apartments.com","href":"/apartments/overview"}]},{"tab":"Realtor","pages":[{"title":"Realtor","href":"/realtor/overview"}]},{"tab":"Zillow","pages":[{"title":"Zillow","href":"/zillow/overview"}]},{"tab":"YouTube","pages":[{"title":"YouTube","href":"/youtube/overview"}]},{"tab":"Instagram","pages":[{"title":"Instagram","href":"/instagram/overview"}]},{"tab":"Facebook","pages":[{"title":"Facebook","href":"/facebook/overview"}]},{"tab":"TikTok","pages":[{"title":"TikTok","href":"/tiktok/overview"}]},{"tab":"Twitter","pages":[{"title":"Twitter","href":"/api-reference/introduction"}]},{"tab":"ChatGPT","pages":[{"title":"ChatGPT","href":"/chatgpt/overview"}]},{"tab":"Gemini","pages":[{"title":"Gemini","href":"/gemini/overview"}]},{"tab":"Perplexity","pages":[{"title":"Perplexity","href":"/api-reference/endpoint/perplexity/ask"}]},{"tab":"Copilot","pages":[{"title":"Copilot","href":"/copilot/overview"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"ASOS","pages":[{"title":"ASOS","href":"/asos/overview"}]},{"tab":"Target","pages":[{"title":"Target","href":"/target/overview"}]},{"tab":"Etsy","pages":[{"title":"Etsy","href":"/etsy/overview"}]},{"tab":"AliExpress","pages":[{"title":"AliExpress","href":"/aliexpress/overview"}]},{"tab":"Best Buy","pages":[{"title":"Best Buy","href":"/bestbuy/overview"}]},{"tab":"GitHub","pages":[{"title":"GitHub","href":"/github/overview"}]},{"tab":"AutoScout24","pages":[{"title":"AutoScout24","href":"/autoscout24/overview"}]},{"tab":"Brave","pages":[{"title":"Brave","href":"/brave/overview"}]},{"tab":"Yelp","groups":[{"group":"Overview","pages":[{"title":"Yelp Search API","description":"Search ranked Yelp businesses for any location with ratings, review counts, categories, price, address and opening hours. Ads come back separately.","href":"/yelp/overview"}]},{"group":"API reference","pages":[{"title":"Search businesses","openapi":"GET /v1/yelp/search","href":"/api-reference/endpoint/yelp/search"},{"title":"List markets","openapi":"GET /v1/yelp/markets","description":"Yelp sites this API searches.","href":"/api-reference/endpoint/yelp/markets"}]}]}]},"basePath":"","title":"Search businesses - ScrapeBadger","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}