# Yellow Pages Spain Scraper(Listing)

Scrape basic information (Title, URL, Category, Phone number, Website, Address etc.) of Páginas Amarillas España.

- Template page: [https://www.octoparse.com/template/paginas-amarillas-listados-scraper](https://www.octoparse.com/template/paginas-amarillas-listados-scraper)
- Categories: Directories
- Status: `PUBLISHED`
- Run mode: `BOTH`

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

## Output

The current workflow extracts 11 fields, including `Calle`, `Categoría`, `Ciudad`, `Código_Postal`, `Descripción`, `Hora_actual`, `Horario`, `Sitio_web`, `Teléfono`, `Título`, `URL`.

## 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 URL(s) de página de listado and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URL(s) de página de listado

Required. Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

## How to Use

# Yellow Pages Spain Scraper(Listing)

This template collects basic listing information (title, URL, category, phone, website, address, etc.) from Páginas Amarillas España at https://www.paginasamarillas.es/.

## Pricing

Currently no per-line charge.

## Input

- **URL(s) de página de listado** (required): enter one or more values, one per line.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Output

The template returns structured rows with the listing fields defined in its Output section (for example, `Título`, `URL`, `Teléfono`, `Sitio_web`, `Calle`, `Ciudad`). It only collects data that Páginas Amarillas displays; `Código_Postal`, `Ciudad`, and `Hora_actual` may be empty when the source record does not provide them.

## Scheduling, Export, and API

- Run locally or in the cloud.
- Schedule recurring runs and export to CSV, Excel, JSON, databases, cloud storage, or reporting/AI workflows.
- Use Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates) to reuse collected data.
- Scheduling and API access may require a paid Octoparse plan. For local scheduled runs, keep your computer and Octoparse open.

## Limitations

- Collects listing/search-result fields only; it does not collect complete detail-page data. Use a detail-page template when deeper record data is required.
- Does not add data that Páginas Amarillas does not display.

## Tips

- Start with one or a few inputs and review returned rows before scaling.
- Use the most specific valid `URL(s) de página de listado` to reduce unrelated or duplicate records.
- When available, use a stable URL/identifier from the output fields as a deduplication key.

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

- [Yellow Pages Spain Scraper(Product Details)](https://www.octoparse.com/template/paginas-amarillas-detalles-scraper)
- [Yellow Pages Canada Scraper (Business Listing)](https://www.octoparse.com/template/yellow-pages-canada-scraper-product-listing)
- [Yellow Pages Listing Scraper (Australia)](https://www.octoparse.com/template/yellow-pages-australia-scraper-product-listing)
- [Yellow Pages Scraper](https://www.octoparse.com/template/yellow-page-scraper)
- [Yellow Pages Details Scraper (Australia)](https://www.octoparse.com/template/yellow-pages-australia-scraper-product-details)

## Input Schema

```json
{
  "title": "Yellow Pages Spain Scraper(Listing) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL_de_página_de_listado": {
      "title": "URL(s) de página de listado",
      "description": "",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL_de_página_de_listado"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRL_de_página_de_listado": [
    "https://www.paginasamarillas.es/a/marketing/malaga/marbella/"
  ]
}
```

Example 2

```json
{
  "uRL_de_página_de_listado": [
    "https://www.paginasamarillas.es/a/marketing/malaga/marbella/"
  ]
}
```

Example 3

```json
{
  "uRL_de_página_de_listado": [
    "https://www.paginasamarillas.es/a/marketing/malaga/marbella/"
  ]
}
```

Example 4

```json
{
  "uRL_de_página_de_listado": [
    "https://www.paginasamarillas.es/a/marketing/malaga/marbella/"
  ]
}
```

Example 5

```json
{
  "uRL_de_página_de_listado": [
    "https://www.paginasamarillas.es/a/marketing/malaga/marbella/"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Calle": {
      "type": "string",
      "description": ""
    },
    "Categoría": {
      "type": "string",
      "description": ""
    },
    "Ciudad": {
      "type": "string",
      "description": ""
    },
    "Código_Postal": {
      "type": "string",
      "description": ""
    },
    "Descripción": {
      "type": "string",
      "description": ""
    },
    "Hora_actual": {
      "type": "string",
      "description": ""
    },
    "Horario": {
      "type": "string",
      "description": ""
    },
    "Sitio_web": {
      "type": "string",
      "description": ""
    },
    "Teléfono": {
      "type": "string",
      "description": ""
    },
    "Título": {
      "type": "string",
      "description": ""
    },
    "URL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Yellow Pages Spain Scraper(Listing) 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

Example 1

```json
{
  "Calle": "Urbanización Reserva los Granados, 322",
  "Categoría": " Marketing: consultorías ",
  "Ciudad": "Marbella",
  "Código_Postal": "29602",
  "Descripción": "",
  "Hora_actual": "2026-11-17 19:28:57.177",
  "Horario": "",
  "Sitio_web": "",
  "Teléfono": "609529646",
  "Título": "Mco Marketing",
  "URL": "https://www.paginasamarillas.es/f/marbella/mco-marketing_233219773_000000001.html"
}
```

Example 2

```json
{
  "Calle": "Poligono Comercial Nueva Campana, S/N 0",
  "Categoría": " Marketing: consultorías ",
  "Ciudad": "Nueva Andalucía",
  "Código_Postal": "29660",
  "Descripción": "",
  "Hora_actual": "2026-11-15 11:13:39.984",
  "Horario": "",
  "Sitio_web": "",
  "Teléfono": "662272905",
  "Título": "Next Step Media",
  "URL": "https://www.paginasamarillas.es/f/nueva-andalucia/next-step-media_234487957_000000001.html"
}
```

Example 3

```json
{
  "Calle": "Avenida Ricardo Soriano, 50",
  "Categoría": " Marketing: consultorías ",
  "Ciudad": "Marbella",
  "Código_Postal": "29601",
  "Descripción": "",
  "Hora_actual": "2026-11-13 02:58:18.233",
  "Horario": "",
  "Sitio_web": "",
  "Teléfono": "607774050",
  "Título": "Jacqueline Campos Comunicación",
  "URL": "https://www.paginasamarillas.es/f/marbella/jacqueline-campos-comunicacion_230158818_000000001.html"
}
```

Example 4

```json
{
  "Calle": "Zapatari Kalea ",
  "Categoría": " Marketing: consultorías ",
  "Ciudad": "Vitoria-Gasteiz",
  "Código_Postal": "01001",
  "Descripción": " Te esperamos. ",
  "Hora_actual": "2026-11-10 18:35:12.376",
  "Horario": "",
  "Sitio_web": "",
  "Teléfono": "653820308",
  "Título": "R Punto E",
  "URL": "https://www.paginasamarillas.es/f/vitoria-gasteiz/r-punto-e_220131023_000000001.html"
}
```

Example 5

```json
{
  "Calle": "Zapatari Kalea ",
  "Categoría": " Marketing: consultorías ",
  "Ciudad": "Vitoria-Gasteiz",
  "Código_Postal": "01001",
  "Descripción": " Te esperamos. ",
  "Hora_actual": "2026-11-02 14:09:57.475",
  "Horario": "",
  "Sitio_web": "",
  "Teléfono": "653820308",
  "Título": "R Punto E",
  "URL": "https://www.paginasamarillas.es/f/vitoria-gasteiz/r-punto-e_220131023_000000001.html"
}
```

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

```json
{
  "templateName": "paginas-amarillas-listados-scraper",
  "taskName": "Yellow Pages Spain Scraper(Listing)",
  "parameters": "{\"uRL_de_página_de_listado\":[\"https://www.paginasamarillas.es/a/marketing/malaga/marbella/\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"uRL_de_página_de_listado\":[\"https://www.paginasamarillas.es/a/marketing/malaga/marbella/\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "paginas-amarillas-listados-scraper",
        "taskName": "Yellow Pages Spain Scraper(Listing)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "paginas-amarillas-listados-scraper",
  "taskName": "Yellow Pages Spain Scraper(Listing)",
  "parameters": "{\"uRL_de_página_de_listado\":[\"https://www.paginasamarillas.es/a/marketing/malaga/marbella/\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `paginas-amarillas-listados-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/paginas-amarillas-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/paginas-amarillas-listados-scraper-manifest.json)
