# Get Yelp Business Details by URL or Search

**Use case:** 

Extract Yelp business data: address, hours, ratings, price range, phone, and categories. Search by location and category, or scrape direct business URLs.

## Input

```json
{
  "mainMode": "listing_urls",
  "listingUrls": [
    "https://www.yelp.com/biz/best-bagel-and-coffee-new-york",
    "best-bagel-and-coffee-new-york",
    "j1S3NUrkB3BVT49n_e76NQ"
  ],
  "searchMode": "query",
  "searchQuery": "auto repair service",
  "category": "autorepair",
  "location": "90211",
  "sort": "default",
  "openNow": false,
  "priceRange": [],
  "maxResults": 50,
  "scrapeReviews": false,
  "maxReviews": 50,
  "reviewRating": "any",
  "reviewSortBy": "relevance_desc",
  "reviewCutoffDate": "",
  "reviewKeywords": [],
  "scrapeBusinessDetails": true,
  "scrapeMedia": false,
  "maxMedia": 50
}
```

## Output

```json
{
  "id": {
    "label": "ID"
  },
  "name": {
    "label": "Name"
  },
  "url": {
    "label": "URL"
  },
  "phone": {
    "label": "Phone"
  },
  "categories": {
    "label": "Categories"
  },
  "avg_rating": {
    "label": "Rating"
  },
  "review_count": {
    "label": "Reviews"
  },
  "price": {
    "label": "Price"
  },
  "is_closed": {
    "label": "Closed"
  },
  "is_temp_closed": {
    "label": "Temp Closed"
  },
  "is_yelp_guaranteed": {
    "label": "Yelp Guaranteed"
  },
  "address1": {
    "label": "Address"
  },
  "city": {
    "label": "City"
  },
  "state": {
    "label": "State"
  },
  "zip": {
    "label": "ZIP"
  },
  "country": {
    "label": "Country"
  },
  "distance": {
    "label": "Distance"
  },
  "query": {
    "label": "Query"
  },
  "search_type": {
    "label": "Search Type"
  }
}
```

## About this Actor

This example demonstrates how to use [Yelp Scraper AIO - Reviews, Photos & Business Details](https://apify.com/mof1re/yelp-scraper-pro-all-in-one) with a specific input configuration. Visit the [Actor detail page](https://apify.com/mof1re/yelp-scraper-pro-all-in-one) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/mof1re/yelp-scraper-pro-all-in-one.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).