# Superpages Details Page Scraper (Cloud)

Scrape business name, address, telephone, website, social media links, etc, on Superpages by keyword and location/zip code.

- Template page: [https://www.octoparse.com/template/superpages-listing-scraper](https://www.octoparse.com/template/superpages-listing-scraper)
- Categories: Lead Generation
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from detail pages.

## Output

The current workflow extracts 20 fields, including `Address`, `Business_name`, `Categories`, `Description`, `Detail_URL`, `Email`, `Fax`, `General_info`, `Neighbourhoods`, `Opening_hours`, `Payment_options`, `Price_range`, `Primary_category`, `Rating`, `Review_count`, `Service_and_products`, `Telephone`, `TollFree`, `Website`, `Year_in_business`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Keyword combinations (up to 100,000) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keyword combinations (up to 100,000)

Required. Enter a list of keyword pairs to search on Superpages. Constraints: minItems=1; maxItems=100000; items.minLength=1; items.maxLength=50000.

## How to Use

## Superpages Details Page Scraper (Cloud) – Usage Guide

This template collects business details from [Superpages](https://www.superpages.com/) using keyword–location pairs. It returns names, phones, websites, categories, addresses, opening status, amenities, and workflow progress fields.

### Pricing

The template is **free of charge** with no per-line usage fee. Octoparse plan or resource limits may still apply.

### Input

- **Keyword combinations** (Required) – Enter a list of keyword–location pairs to search on Superpages.  
  **Limit:** Up to 100,000 entries per run.

### How to Use

1. Open **Superpages Details Page Scraper (Cloud)** and click **Try it!**.
2. Fill in the **Keyword combinations** field using the format described above.
3. Run the task in the Octoparse cloud.
4. After the task completes, review the exported fields and download the dataset.

### Output Fields

The exported data includes:

- `Keyword`, `Location`, `Progress`
- `Name`, `Phone`, `Website`, `Direction_URL`
- `Category_0`, `Category_1`, `Category_3`
- `Address`, `Open_Status`, `Amenities`
- `FollowField` (workflow internal)

### Tips

- Start with a focused list of keyword–location pairs to verify the output before scaling up.
- Keep the `Keyword` and `Location` fields in your export to trace each row back to its search input.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Google Maps Listing and Details Page Scraper (Cloud)](https://www.octoparse.com/template/google-maps-listing-and-details-page-scraper)
- [LinkedIn Job Details Page Scraper](https://www.octoparse.com/template/eeeeeee)
- [Superpages Scraper](https://www.octoparse.com/template/superpages-scraper)
- [Gelbe Seiten Details Scraper (Cloud by URLs)](https://www.octoparse.com/template/gelbe-seiten-details-scraper-cloud)
- [Mercari Product Details Scraping by URL (Cloud Only)](https://www.octoparse.com/template/mercari-product-detail-url-scraper-cloud)

## Input Schema

```json
{
  "title": "Superpages Details Page Scraper (Cloud) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keyword_combinations": {
      "title": "Keyword combinations (up to 100,000)",
      "description": "Enter a list of keyword pairs to search on Superpages.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 50000
      },
      "minItems": 1,
      "maxItems": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keyword_combinations"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Address": {
      "type": "string",
      "description": ""
    },
    "Business_name": {
      "type": "string",
      "description": ""
    },
    "Categories": {
      "type": "string",
      "description": ""
    },
    "Description": {
      "type": "string",
      "description": ""
    },
    "Detail_URL": {
      "type": "string",
      "description": ""
    },
    "Email": {
      "type": "string",
      "description": ""
    },
    "Fax": {
      "type": "string",
      "description": ""
    },
    "General_info": {
      "type": "string",
      "description": ""
    },
    "Neighbourhoods": {
      "type": "string",
      "description": ""
    },
    "Opening_hours": {
      "type": "string",
      "description": ""
    },
    "Payment_options": {
      "type": "string",
      "description": ""
    },
    "Price_range": {
      "type": "string",
      "description": ""
    },
    "Primary_category": {
      "type": "string",
      "description": ""
    },
    "Rating": {
      "type": "string",
      "description": ""
    },
    "Review_count": {
      "type": "string",
      "description": ""
    },
    "Service_and_products": {
      "type": "string",
      "description": ""
    },
    "Telephone": {
      "type": "string",
      "description": ""
    },
    "TollFree": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    },
    "Year_in_business": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Superpages Details Page Scraper (Cloud) output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

No verified real input/output examples are currently available.

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `superpages-listing-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/superpages-listing-scraper.json)
- [Manifest](https://www.octoparse.com/templates/superpages-listing-scraper-manifest.json)
