# Superpages Scraper - US Business Directory Leads (`confidential_gnat/superpages-scraper`) Actor

Scrape US businesses from Superpages (superpages.com): name, phone, address, categories, website, rating and reviews count, plus optional coordinates and details. Search by keyword and city or paste a URL. Export JSON, CSV or Excel.

- **URL**: https://apify.com/confidential_gnat/superpages-scraper.md
- **Developed by:** [ActorFlow](https://apify.com/confidential_gnat) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Superpages Business Directory Scraper (superpages.com)

![Superpages Business Directory Scraper cover - US business leads with 28 data fields per business](https://i.postimg.cc/xCGCtwMy/t.jpg)

**Scrape US business listings from Superpages (superpages.com)**: name, phone, address, categories, website, rating and review count, plus coordinates, opening hours and neighborhoods from each business page. Export your **business leads** as JSON, CSV or Excel, or call the scraper as an **API**. Paste a Superpages search or category URL, or enter a keyword and a city, and press Start.

**Target website:** [superpages.com](https://www.superpages.com)

### ✨ Features of this Superpages business scraper

- **Business listing extraction** — name, phone, full address, categories, website, rating, number of ratings and years in business for every result.
- **Pagination support** — walks through result pages (30 businesses per page) until your item limit is reached.
- **Business page details** — optional switch that opens each business page for emails, all phone numbers, exact coordinates, opening hours, reviews, brands, services, languages, accreditations, photos, social links and more when listed.
- **Consistent output** — every record has the same fields in the same order, with `null` for anything the page does not show.
- **Keyword and location search** — enter search terms and locations, or paste search and category URLs.
- **Proxy support** — a proxy field is included; the scraper works with proxies off, which keeps runs cheapest.
- **No browser required** — fast, light runs without a headless browser.

### 🚀 How to scrape Superpages business listings in 5 steps

1. [Sign up](https://apify.com/sign-up) for a free Apify account — includes **$5 monthly credit**.
2. Open the actor page and click **Try for free**.
3. Fill in the **Input** fields (a start URL, or search terms and locations).
4. Click **Start** and wait for the run to complete.
5. Download results from the **Output** tab in JSON, CSV, or Excel format.

You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or integrate it directly into your workflows using [Zapier](https://zapier.com/apps/apify), [Make](https://www.make.com/), or [n8n](https://n8n.io/).

### 💰 Pricing for the Superpages scraper

This actor uses **pay-per-result** billing based on the compute units a run consumes.

- New Apify accounts include **$5 of free monthly credit**.
- It costs significantly less to run than browser-based scrapers.
- Switch on **Share results to get the lower price** and every result is billed at the lower rate (see input configuration below).
- Proxies default to disabled; leaving them off keeps runs cheapest.

### 🔧 Superpages scraper input configuration

![Superpages Scraper input form in Apify Console: search or business URLs, max items per search, scrape business pages, share results to get the lower price, search terms and locations](https://i.postimg.cc/k5fXkQBq/image.png)

1. **Search or business URLs** (`startUrls`) — Superpages search, category or business page links.
2. **Max items per search** (`maxItems`) — how many businesses to save per search.
3. **Scrape business pages** (`scrapeDetails`) — open each business page for coordinates, all phones, hours and more.
4. **Share results to get the lower price** (`shareData`) — optional; switch on for the lower result price.
5. **Search terms** (`searchTerms`) — keywords such as plumber or dentist.
6. **Locations** (`locations`) — cities such as Los Angeles, CA or Austin, TX.

| Field | Type | Required | Default | Description |
| ----- | ---- | -------- | ------- | ----------- |
| Search or business URLs (`startUrls`) | array | — | `https://www.superpages.com/los-angeles-ca/plumbers` | Superpages search pages, category pages or single business pages. Leave empty to use search terms and locations. |
| Max items per search (`maxItems`) | integer | — | 5 | Maximum businesses saved per search (30 per results page). Sponsored ads are not counted. |
| Scrape business pages (`scrapeDetails`) | boolean | — | true | Open every business page for emails, all phones, coordinates, hours, reviews, brands, services, photos and more. Slower; turn off for the basic fields only. |
| Share results to get the lower price (`shareData`) | boolean | — | false | Optional. Lets a copy of the public business data scraped in the run be kept in the developer's research dataset (results only, never your input or account details). Runs with this on are billed at the lower result price. |
| Search terms (`searchTerms`) | array | — | — | What to search for, for example plumber or dentist. Each term is searched in every location. |
| Locations (`locations`) | array | — | — | Where to search, for example Los Angeles, CA. Each location is searched for every term. |
| Proxy configuration (`proxyConfiguration`) | object | — | proxy off | Not needed; leave proxies off. |

**Supported URL types:**

- Category pages: `https://www.superpages.com/los-angeles-ca/plumbers`
- Search pages: `https://www.superpages.com/search?search_terms=dentist&geo_location_terms=Austin%2C+TX`
- Business pages: `https://www.superpages.com/los-angeles-ca/bpp/rodriguez-plumbing-13465240`

### 📦 Superpages scraper output data

Each record is a JSON object with exactly the same 44 keys every time: `businessId`, `name`, `url`, `searchUrl`, `tagline`, `description`, `phone`, `phones`, `email`, `emails`, `website`, `otherLinks`, `address`, `street`, `city`, `region`, `postalCode`, `country`, `latitude`, `longitude`, `categories`, `specialties`, `rating`, `ratingCount`, `reviews`, `yearsInBusiness`, `yearsWithDirectory`, `foundingYear`, `hours`, `brands`, `products`, `services`, `amenities`, `languages`, `alsoKnownAs`, `locationInfo`, `neighborhoods`, `accreditations`, `paymentMethods`, `socialLinks`, `images`, `imageUrl`, `snippet`, `scrapedAt`. A field the page does not show is `null`, so every row has the same shape. There is **1 output view**, **Overview**, a compact table with name, phone, address, categories, website, rating, number of ratings and the Superpages link. Fields that only exist on business pages (email, hours, reviews, coordinates and more) are `null` unless you switch on business page scraping.

**Output at a glance:**

| Name | Phone | Email | City | Categories | Rating |
| ---- | ----- | ----- | ---- | ---------- | ------ |
| [Anawalt Lumber](https://www.superpages.com/los-angeles-ca/bpp/anawalt-lumber-13945594?lid=1002108313121) | (844) 699-3144 | ebonilla@anawaltlumber.com | Los Angeles | Plumbers | 4 |
| [Payless '4' Plumbing](https://www.superpages.com/los-angeles-ca/bpp/payless-4-plumbing-461161788) | (323) 468-9900 | — | — | Plumbers | 5 |

**Sample output (raw JSON, lists shortened to 2 items):**

```json
[
  {
    "businessId": "13945594",
    "name": "Anawalt Lumber",
    "url": "https://www.superpages.com/los-angeles-ca/bpp/anawalt-lumber-13945594?lid=1002108313121",
    "searchUrl": "https://www.superpages.com/los-angeles-ca/plumbers",
    "tagline": "Customer service is what sets us apart from our competitors!",
    "description": "Gardens Most Knowledgeable & Helpful Staff in the Area Hassle Free Returns on Stock Items Prompt Delivery Service Credit Accounts Available Experts in Special Orders Glass and Plexiglas Cutting Re-screening for Doors and Windows Full Rental Department at Pico & Highland Contractor Referrals Key Making Plant Repotting Plant Doctors",
    "phone": "(844) 699-3144",
    "phones": [
      "(844) 699-3144"
    ],
    "email": "ebonilla@anawaltlumber.com",
    "emails": [
      "ebonilla@anawaltlumber.com",
      "rrios@anawaltlumber.com"
    ],
    "website": "http://www.anawaltlumber.com/",
    "otherLinks": [
      "http://www.anawaltlumber.com/"
    ],
    "address": "11060 W Pico Blvd, Los Angeles, CA 90064",
    "street": "11060 W Pico Blvd",
    "city": "Los Angeles",
    "region": "CA",
    "postalCode": "90064",
    "country": "US",
    "latitude": 34.037228,
    "longitude": -118.434235,
    "categories": [
      "Plumbers",
      "Builders Hardware"
    ],
    "specialties": [
      "Gardens"
    ],
    "rating": 4,
    "ratingCount": 10,
    "reviews": [
      {
        "author": "Evelyn j J.",
        "rating": 5,
        "date": "2024-04-29",
        "text": "Team was very knowledgeable.... Such a smart and polite too....Best customer service I’ve ever received. Thank you!"
      },
      {
        "author": "Rachel A.",
        "rating": 5,
        "date": "2024-04-20",
        "text": "Co workers were great. Great environment to work in. good customer service skills. Good workers, mostly. Terrible management."
      }
    ],
    "yearsInBusiness": 103,
    "yearsWithDirectory": 5,
    "foundingYear": 1923,
    "hours": "Mon - Fri: 6:00 am - 8:00 pm; Sat: 8:00 am - 8:00 pm; Sun: 9:00 am - 6:00 pm",
    "brands": [
      "Jeld-Wen",
      "Marvin"
    ],
    "products": "Abrasives",
    "services": "Plywood Siding Building Materials Lumber Paint Electrical Hardware Plumbing Housewares Automotive Nursery",
    "amenities": "Huge Inventory & Friendly Service",
    "languages": [
      "English",
      "Spanish"
    ],
    "alsoKnownAs": [
      "Anawalt Lumber Co"
    ],
    "locationInfo": "3 Locations to Serve You: 11060 W. Pico Blvd., Los Angeles, CA 90064, (310) 478-0324 1001 N. Highland Ave., Hollywood, CA 90038, (323) 464-1600 641 N. Robertson Blvd., West Hollywood, CA 90069, (310) 652-6202",
    "neighborhoods": [
      "Westside",
      "West Los Angeles"
    ],
    "accreditations": [
      "Doors"
    ],
    "paymentMethods": [
      "amex",
      "discover"
    ],
    "socialLinks": [
      "https://www.facebook.com/anawaltlumberco"
    ],
    "images": [
      "https://i3.ypcdn.com/blob/b9c5e4b83f22d9be8946e1edb43b361d17e438a0",
      "https://i3.ypcdn.com/blob/fe2d1daa88857e6e19f2f093c8aff9b409fd65fd"
    ],
    "imageUrl": "https://i3.ypcdn.com/blob/b9c5e4b83f22d9be8946e1edb43b361d17e438a0",
    "snippet": "Team was very knowledgeable.... Such a smart and polite too....Best customer service I’ve ever received. Thank you!\"",
    "scrapedAt": "2026-10-25T16:24:53.438Z"
  },
  {
    "businessId": "461161788",
    "name": "Payless '4' Plumbing",
    "url": "https://www.superpages.com/los-angeles-ca/bpp/payless-4-plumbing-461161788",
    "searchUrl": "https://www.superpages.com/los-angeles-ca/plumbers",
    "tagline": null,
    "description": null,
    "phone": "(323) 468-9900",
    "phones": [
      "(323) 468-9900",
      "(800) 220-0209"
    ],
    "email": null,
    "emails": null,
    "website": "http://www.paylessforplumbing.com/",
    "otherLinks": null,
    "address": "Serving Los Angeles",
    "street": null,
    "city": null,
    "region": null,
    "postalCode": null,
    "country": "US",
    "latitude": null,
    "longitude": null,
    "categories": [
      "Plumbers",
      "Bathtubs & Sinks-Repair & Refinish"
    ],
    "specialties": null,
    "rating": 5,
    "ratingCount": 4,
    "reviews": [
      {
        "author": "amit.sahoo.10048",
        "rating": 5,
        "date": "2013-02-18",
        "text": "After reading reviews on I decided to call Payless 4 Plumbing to clean my drain and repair my sewers. I got to tell you I was skeptical at first but little Mike knew what he was doing and got my mess cleaned up in a couple of hours."
      },
      {
        "author": "sammy1sees",
        "rating": 5,
        "date": "2012-10-13",
        "text": "I had my sewer line replaced with this new technology called trenchless sewer lining. Payless 4 Plumbing replaced my sewer line in two days. Without trenchless sewer repair I would have had to tear out the rose bushes my mother and I planted 20 years ago. Thank you Payless 4 Plumbing for repairing my sewer line."
      }
    ],
    "yearsInBusiness": null,
    "yearsWithDirectory": null,
    "foundingYear": null,
    "hours": "Mon - Sun: Open 24 Hours",
    "brands": [
      "Price Pfister"
    ],
    "products": null,
    "services": null,
    "amenities": null,
    "languages": null,
    "alsoKnownAs": null,
    "locationInfo": null,
    "neighborhoods": null,
    "accreditations": null,
    "paymentMethods": [
      "amex",
      "discover"
    ],
    "socialLinks": null,
    "images": [
      "https://i1.ypcdn.com/ypus/images/default-thumbnails/thumbnail-1.svg?95a47e89b"
    ],
    "imageUrl": "https://i1.ypcdn.com/ypus/images/default-thumbnails/thumbnail-1.svg?95a47e89b",
    "snippet": "After reading reviews on I decided to call Payless 4 Plumbing to clean my drain and repair my sewers. I got to tell you I was skeptical at first but little Mike knew what he…",
    "scrapedAt": "2026-10-25T16:24:46.107Z"
  }
]
```

### 🐍 How to scrape Superpages with Python, JavaScript or the API

Run the actor programmatically with the official Apify clients. Replace `<YOUR_API_TOKEN>` with the token from your [Apify Console](https://console.apify.com/account/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run = client.actor("confidential_gnat/superpages-scraper").call(run_input={
    "startUrls": [{"url": "https://www.superpages.com/los-angeles-ca/plumbers"}],
    "maxItems": 5,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**JavaScript** (`npm install apify-client`):

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

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });

const run = await client.actor('confidential_gnat/superpages-scraper').call({
    startUrls: [{ url: 'https://www.superpages.com/los-angeles-ca/plumbers' }],
    maxItems: 5,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**cURL** — start a run and wait for the dataset:

```bash
curl -X POST "https://api.apify.com/v2/acts/confidential_gnat~superpages-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": [{"url": "https://www.superpages.com/los-angeles-ca/plumbers"}], "maxItems": 5}'
```

### 💡 What you can use Superpages business data for

- Building local **lead lists** of plumbers, dentists, lawyers or any other trade in a chosen city
- Sales prospecting with business phone numbers, websites and addresses
- Competitor research: ratings, review counts and years in business by category
- Mapping service providers with exact coordinates and neighborhoods
- Keeping a CRM or directory database up to date with fresh business details

Marketers, sales teams, agencies and market researchers in home services, healthcare, legal and retail typically use this data.

### ⚠️ Limitations of the Superpages scraper

- **Free Apify plan** — free accounts can scrape up to 10 businesses per month in total, counted across all runs and searches (the allowance is tracked per account and resets each calendar month, UTC). The run log shows how many are left. Paid plans have no such limit and are not tracked.
- **Sponsored ads** — paid ad slots at the top of results are skipped and are not saved or counted.
- **Search depth** — Superpages serves a limited number of result pages per search; for more businesses use narrower searches (other keywords or cities).
- **Business page fields** — email, website, hours and social links appear only when the business listed them; many free listings have none.
- **Slower detail runs** — the page loading is retried several times per page, so runs with business pages switched on take longer.

### ❓ Superpages scraper FAQ

#### Can I scrape Superpages legally?

The actor only collects data that is already publicly visible on superpages.com — no login, paywall or private content is accessed. Scraping publicly available data is generally considered lawful (see *hiQ Labs v. LinkedIn*), but you are responsible for complying with the site's Terms of Service and applicable laws such as GDPR and CCPA if personal data is involved.

#### What data does the Superpages scraper return?

Name, phone, address, city, state, postal code, categories, website, rating, number of ratings, years in business and a short review snippet for every business. With business page scraping on you also get emails, all phone numbers, coordinates, tagline and description, opening hours, reviews, brands, products, services, languages, accreditations, payment methods, photos and social links when listed.

#### How many businesses can I scrape from one Superpages search?

Free Apify accounts get 10 businesses per month in total; paid accounts have no monthly limit. `maxItems` limits the number of businesses saved per start URL or per keyword-and-location search; a results page holds 30. A single search can show hundreds or over a thousand businesses, and the site stops serving pages after a limited depth.

#### Do I need a proxy to scrape superpages.com?

No. The proxy field is off by default and the scraper works without it, which keeps runs cheapest. Leave it off.

#### How do I scrape Superpages with Python?

Use the Python example above with the `apify-client` package, then iterate over the dataset items returned by the run.

#### How do I get the lower price?

Turn on **Share results to get the lower price** in the input. The public business data the run scrapes is then also kept in the developer's research dataset, and every result is billed at the lower rate. Your search input and account details are never stored.

#### Can I run this Superpages scraper on a schedule?

Yes. Use Apify Schedules to run it daily or weekly with the same input and compare the exported datasets.

#### What output formats are supported?

JSON, CSV, Excel, XML and RSS, either from the **Output** tab or through the Apify API.

#### Why do some businesses show a service area instead of a street address?

Some listings only state where they work, for example "Serving Los Angeles". Switch on business page scraping to get the street address when the business page lists one.

### 🔗 Relevant actors for Superpages and business directories

| Scraper | Description |
| ------- | ----------- |
| [🇺🇸 Yellow Pages USA Scraper - Emails & Leads](https://apify.com/confidential_gnat/yellowpages-usa-scraper) | Scrape US businesses from Yellow Pages with emails, phone, address and rating. |
| [🇨🇦 Yellow Pages Canada Scraper - Emails & Leads](https://apify.com/confidential_gnat/yellowpages-canada-scraper) | Scrape Canadian businesses from Yellow Pages Canada with emails and contacts. |
| [🇬🇧 Yellow Pages UK Scraper - Emails & Leads](https://apify.com/confidential_gnat/yellowpages-uk-scraper) | Scrape UK businesses from Yell with emails, phone and address. |
| [BBB Emails & Info Scraper](https://apify.com/confidential_gnat/bbb-business-scraper) | Scrape Better Business Bureau businesses: name, phone, address and BBB rating. |
| [Páginas Amarillas Spain Business Scraper](https://apify.com/confidential_gnat/paginasamarillas-business-scraper) | Scrape business listings from Páginas Amarillas Spain with name and phone. |

### 🔗 Other actors you may find useful

| Scraper | Description |
| ------- | ----------- |
| [Craigslist Listings Scraper](https://apify.com/confidential_gnat/craigslist-listings-scraper) | Scrape Craigslist classified listings in any city and category. |
| [Rightmove Property Scraper](https://apify.com/confidential_gnat/rightmove-property-scraper) | Scrape UK property listings from Rightmove: sale and rent. |
| [Vivino Wine Scraper](https://apify.com/confidential_gnat/vivino-wine-scraper) | Scrape wine data from Vivino including winery, vintage and ratings. |
| [XING Jobs Scraper](https://apify.com/confidential_gnat/xing-jobs-scraper) | Scrape job listings from XING Jobs in Germany. |
| [Mercari Japan Scraper](https://apify.com/confidential_gnat/mercari-japan-listings-scraper) | Scrape Mercari Japan listings, prices and sold items. |

### 💬 Support & contact

If you encounter any issues or have questions, please [open an issue](https://apify.com/confidential_gnat/superpages-scraper/issues/open) or reach out via the [Apify Community Forum](https://community.apify.com/).

You can also find more of our actors on the [Actor Flow](https://apify.com/confidential_gnat) page.

# Actor input Schema

## `startUrls` (type: `array`):

Superpages search result pages, category pages or single business pages, for example https://www.superpages.com/los-angeles-ca/plumbers or https://www.superpages.com/search?search_terms=plumbers\&geo_location_terms=Los+Angeles%2C+CA. Leave empty to use the search terms and locations below.

## `maxItems` (type: `integer`):

Maximum businesses saved for each search (30 businesses per results page). Sponsored ads are not counted. Directory searches stop after a limited number of pages; for more, use narrower searches (more search terms or locations).

## `scrapeDetails` (type: `boolean`):

Open every business page for emails, all phone numbers, street address, coordinates, opening hours, reviews, brands, services, languages, accreditations, photos and social links when listed. Slower; turn off for a faster run with the basic fields only.

## `shareData` (type: `boolean`):

Optional. Allow a copy of the public business data this run scrapes to be kept in the developer's research dataset (only the scraped results, never your input or account details). Runs with this enabled are billed at the lower result price.

## `searchTerms` (type: `array`):

What to search for, for example plumber, dentist or italian restaurant. Each term is searched in every location.

## `locations` (type: `array`):

Where to search, for example Los Angeles, CA or Austin, TX. Each location is searched for every search term.

## `proxyConfiguration` (type: `object`):

Not needed: pages are loaded by the Actor's built-in service. Leave proxies off.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.superpages.com/los-angeles-ca/plumbers"
    }
  ],
  "maxItems": 5,
  "scrapeDetails": true,
  "shareData": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://www.superpages.com/los-angeles-ca/plumbers"
        }
    ],
    "maxItems": 5,
    "scrapeDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("confidential_gnat/superpages-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 = {
    "startUrls": [{ "url": "https://www.superpages.com/los-angeles-ca/plumbers" }],
    "maxItems": 5,
    "scrapeDetails": True,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("confidential_gnat/superpages-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.superpages.com/los-angeles-ca/plumbers"
    }
  ],
  "maxItems": 5,
  "scrapeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call confidential_gnat/superpages-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,confidential_gnat/superpages-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/aBT4YwMm8uFAPJAmA/builds/5dvVrFl5VgFnSY7db/openapi.json