# Yellow Pages Scraper 🦘 AUSTRALIA (`jupri/yellowpages-au`) Actor

💫 Scrape YellowPages Australia

- **URL**: https://apify.com/jupri/yellowpages-au.md
- **Developed by:** [cat](https://apify.com/jupri) (community)
- **Categories:** Other, Lead generation
- **Stats:** 430 total users, 0 monthly users, 70.7% runs succeeded, 7 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$30.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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

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).


# README

## 💫 Welcome To YellowPages AU Scraper

<img align="right" height="32" src="https://apify.com/actor-badge?actor=jupri~yellowpages-au&t=2025">

![enter image description here](https://raw.githubusercontent.com/JupriGH/resources/main/cats/cat-yellow.png)

### 📒 About YellowPages

<img width="40%" align="left" src="https://upload.wikimedia.org/wikipedia/commons/f/f1/Two-volume_Yellow_Pages%C2%AE_directory_for_Auckland%2C_New_Zealand.png"> 

The **yellow pages** are [telephone directories](https://en.wikipedia.org/wiki/Telephone_directories "Telephone directories") of [businesses](https://en.wikipedia.org/wiki/Business "Business"), organized by category rather than alphabetically by business name, in which [advertising](https://en.wikipedia.org/wiki/Advertising "Advertising") is sold. The directories were originally printed on yellow paper, as opposed to [white pages](https://en.wikipedia.org/wiki/Telephone_directory "Telephone directory") for non-commercial listings. The traditional term "yellow pages" is now also applied to [online directories](https://en.wikipedia.org/wiki/Electronic_Yellow_Pages "Electronic Yellow Pages") of businesses.

<img width="40%" align="right" src="https://s0.whitepages.com.au/2491f369-4d4e-4ba3-86ae-fb3bcd9b3ed3/white-pages-australia-logo.jpg">

**White Pages Australia**  is a formerly government-owned and now-privatised directory of contact information for people and business entities within  [Australia](https://en.wikipedia.org/wiki/Australia "Australia"). Originally only in the form of a print book delivered to all households for several decades, it now also exists online.[[1]](https://en.wikipedia.org/wiki/White_Pages_Australia#cite_note-1)

Originally named the  [Melbourne Telephone Exchange Company](https://en.wikipedia.org/wiki/Melbourne_Telephone_Exchange_Company "Melbourne Telephone Exchange Company"), White Pages Australia was founded in 1880 as Australia's first telephone exchange. It later became known as the Victorian Telephone Exchange Company and remained a private company until 1887, when it was purchased by the Victorian Colonial Government.[[2]](https://en.wikipedia.org/wiki/White_Pages_Australia#cite_note-2)

### 📒 About This Actor

💫 Scrape publicly available information from YellowPages Australia. Extract a business description, reviews, contacts, external links, and more.

***Disclaimer :***
> - Only scrape first **1,000** results.
> - Free trial limited to the first **50** results, the first **5** queries and **1** parallel task.

### 📒 Output Examples

```yaml
{
    "accreditations": [
        {
            "classification": "AWARD",
            "description": "5th Indian Executive Club Award",
            "imageUrl": "http://s0.yellowpages.com.au/76678894-d77b-4375-b1e2-e4715c632b79/delhi-rocks-melbourne-3000-accreditation.gif"
        }
    ],
    "additionalAddresses": [
        {
            "addressLine": "Postcode 2 / 212 King Street",
            "geoCodeGranularity": "SUBURB",
            "mappable": false,
            "postcode": "3000",
            "state": "VIC",
            "suburb": "Melbourne",
            "type": "POSTAL"
        }
    ],
    "address": {
        "addressLine": "Shop 2/ 212 King St",
        "emsId": "property-99810989",
        "emsPostcode": "3000",
        "emsRegions": [
            "GREATER MELBOURNE",
            "MELBOURNE - INNER CITY SUBURBS",
            "MELBOURNE CBD",
            "MELBOURNE COUNCIL"
        ],
        "emsReverseGeocoded": true,
        "emsState": "VIC",
        "emsSuburb": "MELBOURNE",
        "geoCodeGranularity": "PROPERTY",
        "geoCodeableAddressLine": "212 King St",
        "latitude": "-37.815007",
        "longitude": "144.955389",
        "mappable": true,
        "postcode": "3000",
        "state": "VIC",
        "streetLatitude": "-37.815095",
        "streetLongitude": "144.955191",
        "suburb": "Melbourne",
        "type": "PHYSICAL"
    },
    "advertiserId": 100000966852,
    "advertiserKeywords": [
        "Indian Restaurant, Authentic Curries",
        "Best Indian Restaurant In Melbourne",
        "Delhi Rocks VIC",
        "Best Indian Restaurant",
        "Delhi Rocks Melbourne",
        "Indian Take Away, Catering",
        "Fully Licenced Indian Restaurant",
        "Indian Restaurant Open Till Late",
        "Indian Halal Food, Indian Buffet Restaurant",
        "Indian Thali Deals $10"
    ],
    "brandPackage": {
        "url": "http://s0.yellowpages.com.au/7cb51274-059b-4997-afad-a4eb2cad72c0/delhi-rocks-melbourne-3000-billboard.jpg"
    },
    "businessId": 940037163,
    "businessInfo": {
        "dateEstablished": "1995",
        "numberOfEmployees": "1-10"
    },
    "categories": [
        {
            "id": "33650",
            "name": "Restaurants",
            "sensitive": false
        }
    ],
    "contacts": {
        "primary": [
            {
                "classification": "PREFERRED",
                "displayValue": "(03) 9587 1091",
                "isMetered": true,
                "originalValue": "0385182053",
                "type": "PHONE",
                "value": "0395871091"
            },
            {
                "classification": "MAIN",
                "displayValue": "info.delhirocks@yahoo.com.au",
                "type": "EMAIL",
                "value": "info.delhirocks@yahoo.com.au"
            },
            {
                "classification": "MAIN",
                "displayValue": "www.delhirocks.com.au",
                "type": "URL",
                "value": "http://www.delhirocks.com.au"
            }
        ],
        "secondary": null
    },
    "contentScore": 41,
    "description": {
        "long": "We can provide catering to all types of functions, big or small.",
        "medium": "We are an award winning, family run Indian restaurant that puts freshness, authenticity and culinary craftsmanship above all else. Ever since we opened our doors back in 2006, we have been striving to make sure that Delhi Rocks tops the list of anyone on the hunt for some delicious Indian cuisine. We occasionally provide catering for ANZ, Wipro, AGL, Origin and Mahindra, just to name a few.",
        "short": "Award Winning Indian Restaurants In Melbourne CBD",
        "textBlocks": [
            {
                "label": "Our services:",
                "text": "<ul><li>Samosa chaat</li><li>Papdi chaat</li><li>Bhel puri</li><li>Chicken biryani</li><li>Poori chole halwa </li><li>Makki ki roti sarson ka saag</li><li>Pav bhaji</li><li>Veg fried rice</li><li>Gulabjamun</li><li>Gajar halwa</li><li>A full range of beverages, fully licensed until 1am</li></ul><p></p><p>We are big on authentic style as well as cuisine, as you&#39;ll see when you stroll through our doors. When you sit down to eat, you&#39;ll have the choice to use standard cutlery or go traditional &amp; get stuck in with your fingers. For a taste of the real India right here in Melbourne, <a href=\"http://www.delhirocks.com.au/contact\">call Delhi Rocks</a>.</p>"
            }
        ]
    },
    "digitalListing": true,
    "distance": 0.8624670606007196,
    "faqs": [
        {
            "answer": "We are located in Melbourne, Victoria.",
            "question": "Where are you located?"
        },
        {
            "answer": "We service all of Melbourne and surrounding areas.",
            "question": "What areas do you service?"
        },
        {
            "answer": "You can contact us on 03 9587 1091.",
            "question": "How can we contact you?"
        }
    ],
    "fieldToScoreMap": {
        "Accreditations": 4,
        "Business Logo": 3,
        "Date Established": 1,
        "Email": 4,
        "External Link DEEP_LINK": 1,
        "External Link EDITORIAL": 1,
        "External Link FEED": 2,
        "External Link VIDEO": 4,
        "FAQ": 2,
        "Image Gallery": 4,
        "Number Of Employees": 1,
        "Opening Hours": 2,
        "Product Keywords": 2,
        "Reviews": 2,
        "Text Block": 2,
        "Text Descriptor(Short, Medium, Long)": 2,
        "URLs": 4
    },
    "freeListing": false,
    "hasExposureProducts": false,
    "hasMeteredTn": true,
    "id": "14095492",
    "images": {
        "gallery": [
            {
                "largeUrl": "http://s0.yellowpages.com.au/ba5424dd-dcc4-4229-b4b0-65868c125809/delhi-rocks-melbourne-3000-image.jpg",
                "thumbnailUrl": "http://s0.yellowpages.com.au/0f27cf27-ada2-476f-a54b-5f5a0abc4e44/delhi-rocks-melbourne-3000-thumbnail.jpg"
            },
            {
                "largeUrl": "http://s0.yellowpages.com.au/a3ac2d02-144b-4b2f-9c86-ada017da4f12/delhi-rocks-melbourne-3000-image.jpg",
                "thumbnailUrl": "http://s0.yellowpages.com.au/1fb8c3c8-30a0-4e4f-bbab-34093697b60e/delhi-rocks-melbourne-3000-thumbnail.jpg"
            },
            {
                "largeUrl": "http://s0.yellowpages.com.au/79d9eac7-b22c-430d-a16e-2de6ce914433/delhi-rocks-melbourne-3000-image.jpg",
                "thumbnailUrl": "http://s0.yellowpages.com.au/3cd1c205-4555-4ab0-8cf1-69481d647693/delhi-rocks-melbourne-3000-thumbnail.jpg"
            }
        ],
        "hero": null,
        "logo": {
            "url": "http://s0.yellowpages.com.au/d10edd94-6013-40e9-b06c-85f2c8208ecc/delhi-rocks-melbourne-3000-logo.gif"
        },
        "promotional": null,
        "showcase": null
    },
    "isCategoryQuotable": false,
    "isQuotable": false,
    "lastUpdated": "2020-09-06T01:43:38.815+1000",
    "legacyCustomerId": 940037163,
    "links": [
        {
            "displayValue": "Google+ page",
            "label": "Other",
            "type": "DEEP_LINK",
            "url": "https://plus.google.com/110038901438162335365/?hl=en"
        },
        {
            "displayValue": "About Us",
            "label": "Other",
            "type": "DEEP_LINK",
            "url": "http://www.delhirocks.com.au/about"
        },
        {
            "displayValue": "Urbanspoon/Zomato",
            "label": "Other",
            "type": "EDITORIAL",
            "url": "https://www.zomato.com/melbourne/delhi-rocks-cbd"
        },
        {
            "displayValue": "Australia's Marketing Partner",
            "label": "Twitter Profile Link",
            "type": "FEED",
            "url": "https://twitter.com/sensis"
        },
        {
            "displayValue": "Send us an enquiry online",
            "label": "Other",
            "type": "MESSAGING",
            "url": "http://www.delhirocks.com.au/contact"
        },
        {
            "displayValue": "View our YouTube Video",
            "label": "YouTube Video Individual",
            "type": "VIDEO",
            "url": "https://www.youtube.com/watch?v=1nAJoaN8O8g"
        }
    ],
    "listingType": "Business",
    "name": "Delhi Rocks",
    "normalizedContentScore": 0.8,
    "openingHours": {
        "friday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "monday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "publicHolidays": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "saturday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "sunday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "16:30"
                }
            ]
        },
        "thursday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "tuesday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        },
        "wednesday": {
            "status": "open",
            "times": [
                {
                    "close": "03:00",
                    "open": "11:00"
                }
            ]
        }
    },
    "productCode": "YPD02",
    "productId": 502462326,
    "productVersion": 15,
    "productsAndServices": [],
    "profile": {
        "hasOptedOutOfBooking": true,
        "hasOptedOutOfMessenger": true,
        "hasOptedOutOfQuote": false
    },
    "publicationId": 14095492,
    "pureMobileBusiness": false,
    "reportingId": "14095492",
    "reviewSummaries": [
        {
            "averageRating": 5,
            "changesSequenceNumber": 1652175900361,
            "featuredReview": {
                "familyId": "c9daae6eff40935e4496a74ac7dbe867be91d02bdd63c2f023e6b398502ee136",
                "reviewAuthor": "Pratik T.",
                "reviewRating": "5",
                "reviewText": "If you wanna try Indian Dishes at best, then This is the place to go for.",
                "reviewTitle": "Nice Indian Food",
                "submissionDate": "2017-07-25T08:17:05.000+00:00"
            },
            "namespace": "http://www.yellowpages.com.au",
            "reviewCount": 3,
            "reviewsGroupId": "c9daae6eff40935e4496a74ac7dbe867be91d02bdd63c2f023e6b398502ee136"
        }
    ],
    "salesforceServiceNumber": "502462326",
    "score": 1097,
    "seniorityDate": "2014-12-12T00:00:00.000+1100",
    "serviceNotes": "Please call us today!",
    "services": [
        {
            "label": "Hours of Operation",
            "values": [
                "Open 365 Days",
                "Open Late",
                "Open Monday - Friday",
                "Open Saturdays",
                "Open Sundays"
            ]
        },
        {
            "label": "Events",
            "values": [
                "Award Ceremonies",
                "Club Events",
                "Conferences",
                "Corporate Events",
                "Fund Raisers",
                "Private Parties",
                "Promotions",
                "Receptions",
                "Sporting Events",
                "Themed Events",
                "Trade Shows",
                "Training Sessions",
                "VIP Events"
            ]
        },
        {
            "label": "Style",
            "values": [
                "Indian"
            ]
        },
        {
            "label": "Food",
            "values": [
                "Cheese",
                "Chicken",
                "Goat",
                "Lamb",
                "Meat",
                "Rice",
                "Salads",
                "Vegetables"
            ]
        },
        {
            "label": "Size",
            "values": [
                "51 - 100"
            ]
        },
        {
            "label": "Offering",
            "values": [
                "All Day Dining",
                "Buffets",
                "Curry",
                "Dinner",
                "Halal",
                "Kebabs",
                "Licensed",
                "Lunches",
                "Spicy",
                "Vegetarian"
            ]
        },
        {
            "label": "Features",
            "values": [
                "Accredited",
                "Certified",
                "Delivery",
                "Disabled Access",
                "Family Operated",
                "Family Owned",
                "Guaranteed",
                "Owner Operated",
                "Takeaway"
            ]
        },
        {
            "label": "Payment Method",
            "values": [
                "Cash",
                "Direct Debit",
                "EFT",
                "EFTPOS",
                "Mastercard",
                "Visa"
            ]
        },
        {
            "label": "Price Range",
            "values": [
                "$",
                "$$"
            ]
        }
    ],
    "source": "YELLOW",
    "syndicationOptOutIndicator": false,
    "teamProfiles": [],
    "url": "https://www.yellowpages.com.au/vic/melbourne/delhi-rocks-14095492-listing.html"
}
````

### ✏️ Support

⚡️ Feel free to [reach out](https://console.apify.com/actors/HBD1BXmPhwxQnt0YG/issues) to the developer for any [issues](https://console.apify.com/actors/HBD1BXmPhwxQnt0YG/issues) or suggestions for improvement.

<img src="https://apify-uploads-prod.s3.us-east-1.amazonaws.com/5SxZhwYwpknFk8ek9-cat.gif" width="240">

# Actor input Schema

## `query` (type: `array`):

💡 Search KEYWORDS or URL

## `example` (type: `string`):

💡 QUERY Examples

## `sort` (type: `string`):

No description

## `limit` (type: `integer`):

💡 Number of results (per-query)

## `source` (type: `string`):

No description

## `location` (type: `string`):

Suburb or Post-Code

## `local` (type: `boolean`):

No description

## `popular` (type: `boolean`):

No description

## `open_now` (type: `boolean`):

No description

## `dev_custom_headers` (type: `array`):

💡 Additional HTTP Headers

## `dev_custom_cookies` (type: `array`):

💡 Additional HTTP Cookies

## `dev_transform_fields` (type: `array`):

💡 <b>Transform the resulting output. Select only needed fields.</b><br><br>For nested object use <b>DOT</b>. For example: <pre>address.streetAddress</pre><br>For nested array use <b>NUMBER</b> <i>(index of array element starting from index=0)</i>. For example: <pre>images.0.url</pre>

## `dev_dataset_name` (type: `string`):

💡 <b>Save results into custom named Dataset, use mask to customize dataset name</b><br><br><code>{ACTOR} = actor name<br>{DATE} = date (YYYYMMDD)<br>{TIME} = time (HHMMSS)</code><br><br>This masks can be used to autogenerate Dataset Name.<br><br>example: <i><code>data-{DATE}</code></i><br>Depending on today date the dataset name will be: <code>data-20230603</code><i><br><br>default: <code>data-{ACTOR}-{DATE}-{TIME}</code></i>

## `dev_dataset_clear` (type: `boolean`):

Clear Dataset before insert/update.

## `dev_no_strip` (type: `boolean`):

💡 Keep/Save empty values <i><code>(NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)</code></i>

## `dev_fileupload` (type: `string`):

💡 Upload your file and copy & paste the URL somewhere.

## Actor input object example

```json
{
  "query": [
    "restaurants"
  ],
  "limit": 5
}
```

# 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 = {
    "query": [
        "restaurants"
    ],
    "limit": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("jupri/yellowpages-au").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 = {
    "query": ["restaurants"],
    "limit": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("jupri/yellowpages-au").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 '{
  "query": [
    "restaurants"
  ],
  "limit": 5
}' |
apify call jupri/yellowpages-au --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jupri/yellowpages-au",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Yellow Pages Scraper 🦘 AUSTRALIA",
        "description": "💫 Scrape YellowPages Australia",
        "version": "0.2",
        "x-build-id": "sWnpX5UAEjwwahweX"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jupri~yellowpages-au/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jupri-yellowpages-au",
                "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/jupri~yellowpages-au/runs": {
            "post": {
                "operationId": "runs-sync-jupri-yellowpages-au",
                "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/jupri~yellowpages-au/run-sync": {
            "post": {
                "operationId": "run-sync-jupri-yellowpages-au",
                "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": {
                    "query": {
                        "title": "❓ Query",
                        "type": "array",
                        "description": "💡 Search KEYWORDS or URL",
                        "items": {
                            "type": "string"
                        }
                    },
                    "example": {
                        "title": "💡 Examples",
                        "enum": [
                            "restaurants",
                            "13979100",
                            "https://www.yellowpages.com.au/sa/parafield-gardens/parafield-gardens-community-club-inc-13979100-listing.html"
                        ],
                        "type": "string",
                        "description": "💡 QUERY Examples"
                    },
                    "sort": {
                        "title": "♾️ Sorting",
                        "enum": [
                            "relevance",
                            "distance"
                        ],
                        "type": "string",
                        "description": ""
                    },
                    "limit": {
                        "title": "♾️ Limit",
                        "type": "integer",
                        "description": "💡 Number of results (per-query)"
                    },
                    "source": {
                        "title": "🌐 Source",
                        "enum": [
                            "yellow",
                            "white"
                        ],
                        "type": "string",
                        "description": ""
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Suburb or Post-Code"
                    },
                    "local": {
                        "title": "Local Business",
                        "type": "boolean",
                        "description": ""
                    },
                    "popular": {
                        "title": "Popular",
                        "type": "boolean",
                        "description": ""
                    },
                    "open_now": {
                        "title": "Now Open",
                        "type": "boolean",
                        "description": ""
                    },
                    "dev_custom_headers": {
                        "title": "📜 HTTP HEADERS",
                        "type": "array",
                        "description": "💡 Additional HTTP Headers",
                        "items": {
                            "type": "object",
                            "required": [
                                "key",
                                "value"
                            ],
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "title": "Key"
                                },
                                "value": {
                                    "type": "string",
                                    "title": "Value"
                                }
                            }
                        }
                    },
                    "dev_custom_cookies": {
                        "title": "🍰 HTTP COOKIES",
                        "type": "array",
                        "description": "💡 Additional HTTP Cookies",
                        "items": {
                            "type": "object",
                            "required": [
                                "key",
                                "value"
                            ],
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "title": "Key"
                                },
                                "value": {
                                    "type": "string",
                                    "title": "Value"
                                }
                            }
                        }
                    },
                    "dev_transform_fields": {
                        "title": "♻️ CUSTOM FIELD",
                        "type": "array",
                        "description": "💡 <b>Transform the resulting output. Select only needed fields.</b><br><br>For nested object use <b>DOT</b>. For example: <pre>address.streetAddress</pre><br>For nested array use <b>NUMBER</b> <i>(index of array element starting from index=0)</i>. For example: <pre>images.0.url</pre>",
                        "items": {
                            "type": "object",
                            "required": [
                                "key",
                                "value"
                            ],
                            "properties": {
                                "key": {
                                    "type": "string",
                                    "title": "Key"
                                },
                                "value": {
                                    "type": "string",
                                    "title": "Value"
                                }
                            }
                        }
                    },
                    "dev_dataset_name": {
                        "title": "📁 CUSTOM STORAGE",
                        "type": "string",
                        "description": "💡 <b>Save results into custom named Dataset, use mask to customize dataset name</b><br><br><code>{ACTOR} = actor name<br>{DATE} = date (YYYYMMDD)<br>{TIME} = time (HHMMSS)</code><br><br>This masks can be used to autogenerate Dataset Name.<br><br>example: <i><code>data-{DATE}</code></i><br>Depending on today date the dataset name will be: <code>data-20230603</code><i><br><br>default: <code>data-{ACTOR}-{DATE}-{TIME}</code></i>"
                    },
                    "dev_dataset_clear": {
                        "title": "Clear Storage",
                        "type": "boolean",
                        "description": "Clear Dataset before insert/update."
                    },
                    "dev_no_strip": {
                        "title": "Disable data cleansing",
                        "type": "boolean",
                        "description": "💡 Keep/Save empty values <i><code>(NULL, FALSE, empty ARRAY, empty OBJECT, empty STRING)</code></i>"
                    },
                    "dev_fileupload": {
                        "title": "📁 FILE UPLOADER",
                        "type": "string",
                        "description": "💡 Upload your file and copy & paste the URL somewhere."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
