# Yellowbot Business Search Scraper (`ecomscrape/yellowbot-business-search-scraper`)

Extract business data from YellowBot.com with our professional scraper tool. Automated lead generation, market research & sales intelligence. Get structured JSON output with contact info, addresses & ratings. Perfect for prospecting & competitive analysis.

- **URL**: https://beta-securitybyobscurity.apify.com/ecomscrape/yellowbot-business-search-scraper.md
- **Developed by:** [ecomscrape](https://beta-securitybyobscurity.apify.com/ecomscrape) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$20.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## What does Yellowbot.com Bussiness Search Query Scraper do?

Professional Business Directory Scraping Solution

The YellowBot.com Business Search Query Scraper is your comprehensive tool for extracting valuable business information from YellowBot's extensive directory platform. This powerful scraper transforms raw business listings into structured JSON format, making data integration seamless across your business intelligence systems.

Core Functionality:

- Complete Business Data Extraction - Harvest detailed company profiles, contact information, and service descriptions
- Structured JSON Output - Clean, organized data ready for immediate use in reports and applications
- Automated Collection Process - Streamline your business research with efficient, hands-free data gathering
- Multi-Format Integration - Perfect compatibility with spreadsheets, databases, and custom applications

Business Applications:

- Lead Generation & Prospecting - Build targeted business contact databases
- Market Research & Analysis - Understand local business landscapes and competitive positioning
- Sales Intelligence - Gather comprehensive prospect information for outreach campaigns
- Directory Management - Populate internal business directories with verified data

Why Choose This Scraper:
Eliminate manual data collection tedium while ensuring accuracy and completeness. Whether you're conducting market analysis, building prospect lists, or managing business databases, this tool delivers the reliable YellowBot business data you need to drive informed decisions and accelerate growth.

Yellowbot.com Bussiness Search Query Scraper allows you to collect detailed bussiness information including:

- ID
- URL
- Title
- Total Recommended
- Total Not Recommended
- Phone
- Address
- Tags

## Input & Output

To start collecting Bol bussiness data, simply fill out the input form. Yellowbot.com Bussiness Search Query Scraper recognizes the following input parameters:

- **URLs** - Links to bussiness list by query pages. If you want to scrape from any page, enter the URL of that page, and set the total of pages to scrape. You can paste URLs one at a time or use the Bulk Edit section to add a prepared list.
- **Max items per url** - Don't forget to fill in this field, which allows you to choose the total items per url when scraping from the bussiness listing page.
- **Limit the number of retries** - Maximum number of retries for each URL when collecting data when an unexpected error occurs.
- **Proxy configuration** - Add a proxy to ensure that during the data collection process, you are not detected as a bot.

##### Collect bussiness data from bussiness list by query pages

Example url: https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html

Example Screenshot of bussiness information page:

![](https://i.ibb.co/VpqBmGtw/Screenshot-from-2025-06-20-01-02-14.png)

**Input:**

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20, // Total page you want scrape
  "urls": [ // Links to bussiness list by query pages.
    "https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"
  ]
}
```

**Output:**

You get the output from the Yellowbot.com Bussiness Search Query Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of bussiness information
  {
    "id": "https://www.yellowbot.com/begins-cafe-los-angeles-ca.html",
    "url": "https://www.yellowbot.com/begins-cafe-los-angeles-ca.html",
    "title": "Begin's Cafe",
    "total_recommended": 10,
    "total_not_recommended": 1,
    "phone": "(213) 620-9565",
    "address": {
      "full_address": "100 S Main St, Los Angeles, CA  90012",
      "city": "Los Angeles",
      "zipcode": "90012"
    },
    "tags": [
      {
        "url": "https://www.yellowbot.com/tags/american/Los%20Angeles%2C%20CA/page1.html",
        "name": "American"
      },
      {
        "url": "https://www.yellowbot.com/tags/americantraditional/Los%20Angeles%2C%20CA/page1.html",
        "name": "American Traditional"
      },
      {
        "url": "https://www.yellowbot.com/tags/bioresearchemcom/Los%20Angeles%2C%20CA/page1.html",
        "name": "bioresearchem.com"
      },
      {
        "url": "https://www.yellowbot.com/tags/breakfast/Los%20Angeles%2C%20CA/page1.html",
        "name": "Breakfast"
      },
      {
        "url": "https://www.yellowbot.com/tags/cafe/Los%20Angeles%2C%20CA/page1.html",
        "name": "Cafe"
      },
      {
        "url": "https://www.yellowbot.com/tags/cafeteria/Los%20Angeles%2C%20CA/page1.html",
        "name": "Cafeteria"
      },
      {
        "url": "https://www.yellowbot.com/tags/casual/Los%20Angeles%2C%20CA/page1.html",
        "name": "Casual"
      },
      {
        "url": "https://www.yellowbot.com/tags/cookies/Los%20Angeles%2C%20CA/page1.html",
        "name": "cookies"
      },
      {
        "url": "https://www.yellowbot.com/tags/food/Los%20Angeles%2C%20CA/page1.html",
        "name": "food"
      },
      {
        "url": "https://www.yellowbot.com/tags/goodforgroups/Los%20Angeles%2C%20CA/page1.html",
        "name": "Good for Groups"
      },
      {
        "url": "https://www.yellowbot.com/tags/mobileappdevelopment/Los%20Angeles%2C%20CA/page1.html",
        "name": "mobile app development"
      },
      {
        "url": "https://www.yellowbot.com/tags/none/Los%20Angeles%2C%20CA/page1.html",
        "name": "None"
      },
      {
        "url": "https://www.yellowbot.com/tags/notnecessary/Los%20Angeles%2C%20CA/page1.html",
        "name": "Not Necessary"
      },
      {
        "url": "https://www.yellowbot.com/tags/offshorewebdesignanddevelopment/Los%20Angeles%2C%20CA/page1.html",
        "name": "offshore webdesign and development"
      },
      {
        "url": "https://www.yellowbot.com/tags/pizza/Los%20Angeles%2C%20CA/page1.html",
        "name": "pizza"
      },
      {
        "url": "https://www.yellowbot.com/tags/sandwiches/Los%20Angeles%2C%20CA/page1.html",
        "name": "Sandwiches"
      },
      {
        "url": "https://www.yellowbot.com/tags/street/Los%20Angeles%2C%20CA/page1.html",
        "name": "Street"
      },
      {
        "url": "https://www.yellowbot.com/tags/takeout/Los%20Angeles%2C%20CA/page1.html",
        "name": "Take-out"
      },
      {
        "url": "https://www.yellowbot.com/tags/tea/Los%20Angeles%2C%20CA/page1.html",
        "name": "Tea"
      },
      {
        "url": "https://www.yellowbot.com/tags/websitedevelopment/Los%20Angeles%2C%20CA/page1.html",
        "name": "website development"
      }
    ],
    "from_url": "https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"
  }, // ... Many other bussiness details
]
```

💙 Brand Positioning & Market Presence

Leverage competitor analysis and market positioning insights to strengthen your brand visibility across local business directories and digital platforms.

📈 Business Trend Intelligence & Market Forecasting
Identify emerging business categories, service trends, and market opportunities by analyzing YellowBot's comprehensive business landscape data.

🔬 Data-Driven Business Research & Validation
Conduct thorough market testing and business strategy validation using real-world business data to minimize risks and optimize decision-making processes.

⭐ Reputation Management & Sentiment Tracking
Analyze authentic customer reviews and business ratings to perform comprehensive sentiment analysis, enabling proactive reputation management strategies.

🪧 Targeted Campaign Development & Optimization
Design precision-focused marketing campaigns using verified business data and customer behavior patterns to maximize conversion rates across multiple platforms.

📚 Accelerated Market Research & Competitive Analysis
Streamline your business intelligence gathering with comprehensive directory insights, eliminating time-intensive manual research and analysis processes.

📋 High-Value Lead Generation & Prospecting
Build qualified prospect databases using verified business contact information, enabling personalized outreach campaigns and improved sales conversion rates.

Business Transformation Impact:
Convert raw YellowBot business directory data into actionable market intelligence that drives strategic growth, optimizes marketing investments, and delivers measurable competitive advantages in your target markets.

Results: Enhanced lead quality, improved market positioning, and data-backed business decisions that accelerate revenue growth.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Yellowbot.com Bussiness Search Query Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Bussiness list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/yellowbot-business-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/yellowbot-business-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.yellowbot.com/browse/pizza/Los%20Angeles%2C%20CA/page1.html"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/yellowbot-business-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ecomscrape/yellowbot-business-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Yellowbot Business Search Scraper",
        "description": "Extract business data from YellowBot.com with our professional scraper tool. Automated lead generation, market research & sales intelligence. Get structured JSON output with contact info, addresses & ratings. Perfect for prospecting & competitive analysis.",
        "version": "0.0",
        "x-build-id": "B0ezTJdvNBpOqAIjg"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ecomscrape~yellowbot-business-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ecomscrape-yellowbot-business-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/ecomscrape~yellowbot-business-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ecomscrape-yellowbot-business-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/ecomscrape~yellowbot-business-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ecomscrape-yellowbot-business-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the Bussiness list page urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the Bussiness list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "max_items_per_url": {
                        "title": "Limit the number of items per URL",
                        "type": "integer",
                        "description": "Limit the number of items per URL you want to scrape"
                    },
                    "max_retries_per_url": {
                        "title": "Limit the number of retries for each URL",
                        "type": "integer",
                        "description": "Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load"
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your scraper."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
