# Gelbe Seiten Scraper (by URLs with circles)

Scrape lead title, email, telephone number, industry, etc from Gelbe Seiten by Listing URLs. Use this template to fix the search circles.

- Template page: [https://www.octoparse.com/template/gelbe-seiten-scraper-nach-urls](https://www.octoparse.com/template/gelbe-seiten-scraper-nach-urls)
- Categories: Directories, Lead Generation
- 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 general web pages.

## Output

The current workflow extracts 15 fields, including `Adresse`, `Anzahl_der_Bewertungen`, `Bewertung`, `Branche`, `E_Mail`, `Fax`, `Lead_url`, `PLZ`, `Standort`, `Telefon`, `Titel`, `Website`, `Öffnungsstatus`, `Öffnungszeiten`, `Über_das_Unternehmen`.

## 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 Listing URLs (1-100), IP Proxys and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Listing URLs (1-100)

Required. URLs (1-100) Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=100000.

### IP Proxys

Optional. This function will consume your balance, please make sure you have sufficient balance before starting the task. Do not enable this feature if you choose local capture mode.

## How to Use

# Gelbe Seiten Scraper (by URLs with circles)

Collects lead title, email, telephone number, industry, etc. from [Gelbe Seiten](https://www.gelbeseiten.de/) business listings using listing URLs.

## Input

- **Listing URLs (1-100)** (required): Enter one URL per line.
- **IP Proxys** (optional): Enter the IP proxies requested by the template.

## Output

- `Titel`, `Bewertung`, `Anzahl_der_Bewertungen`, `Branche`, `Adresse`, `PLZ`, `Standort`, `Öffnungsstatus`, `E_Mail`, `Telefon`, `Fax`, `Website`, `Öffnungszeiten`, `Über_das_Unternehmen`, `Lead_url`

## How to Use

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

## Limitations

- Collects only fields displayed on the listing page; does not add data not shown by Gelbe Seiten.
- Fields like `Öffnungszeiten`, `Über_das_Unternehmen`, and `Lead_url` may be empty if the source record doesn’t provide them.

## Tips

- Start with a few inputs to verify results before scaling.
- Use the most specific valid listing URLs (1-100) to reduce unrelated records.
- Use `Titel`, `Bewertung`, `Anzahl_der_Bewertungen`, `Branche`, `Adresse`, `PLZ`, `Standort`, `Öffnungsstatus`, `E_Mail`, or `Telefon` as a deduplication key when available.

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

- [Gelbe Seiten Details Scraper (Cloud by URLs)](https://www.octoparse.com/template/gelbe-seiten-details-scraper-cloud)
- [Gelbe Seiten Listing Scraper (Cloud by keyword pairs)](https://www.octoparse.com/template/gelbe-seiten-listing-scraper-cloud)
- [Gelbe Seiten Scraper](https://www.octoparse.com/template/gelbe-seiten-scraper)
- [Google Maps Listings Scraper (by URLs)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-url)
- [Google Hotel Scraper (by URLs)](https://www.octoparse.com/template/google-hotel-scraper-by-urls)

## Input Schema

```json
{
  "title": "Gelbe Seiten Scraper (by URLs with circles) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "listing_URLs": {
      "title": "Listing URLs (1-100)",
      "description": "URLs (1-100)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "iP_Proxys": {
      "title": "IP Proxys",
      "description": "This function will consume your balance, please make sure you have sufficient balance before starting the task.\nDo not enable this feature if you choose local capture mode.",
      "type": "string",
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "listing_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "listing_URLs": [
    "https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000"
  ]
}
```

Example 2

```json
{
  "listing_URLs": [
    "https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000"
  ]
}
```

Example 3

```json
{
  "listing_URLs": [
    "https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000"
  ]
}
```

Example 4

```json
{
  "listing_URLs": [
    "https://www.gelbeseiten.de/suche/physiotherapie/bamberg?umkreis=5000"
  ]
}
```

Example 5

```json
{
  "listing_URLs": [
    "https://www.gelbeseiten.de/suche/arzt/bamberg?umkreis=5000"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Adresse": {
      "type": "string",
      "description": ""
    },
    "Anzahl_der_Bewertungen": {
      "type": "string",
      "description": ""
    },
    "Bewertung": {
      "type": "string",
      "description": ""
    },
    "Branche": {
      "type": "string",
      "description": ""
    },
    "E_Mail": {
      "type": "string",
      "description": ""
    },
    "Fax": {
      "type": "string",
      "description": ""
    },
    "Lead_url": {
      "type": "string",
      "description": ""
    },
    "PLZ": {
      "type": "string",
      "description": ""
    },
    "Standort": {
      "type": "string",
      "description": ""
    },
    "Telefon": {
      "type": "string",
      "description": ""
    },
    "Titel": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    },
    "Öffnungsstatus": {
      "type": "string",
      "description": ""
    },
    "Öffnungszeiten": {
      "type": "string",
      "description": ""
    },
    "Über_das_Unternehmen": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Gelbe Seiten Scraper (by URLs with circles) 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
{
  "Adresse": "Edigheimer Str. 47, ",
  "Anzahl_der_Bewertungen": "3 Bewertungen",
  "Bewertung": "4.3",
  "Branche": "TISCHLEREIEN",
  "E_Mail": "info@seburger-loske.de",
  "Fax": "0621 6 57 56-99",
  "Lead_url": "https://www.gelbeseiten.de/gsbiz/d9d55859-4610-4349-91b4-89d1a30bc315",
  "PLZ": "67069 ",
  "Standort": "Ludwigshafen am Rhein-Oppau",
  "Telefon": "\n\t\t\t 0621 65 75 60\n\t\t\t ",
  "Titel": "Seburger & Loske e.K.",
  "Website": "http://www.seburger-loske.de/",
  "Öffnungsstatus": "Geöffnet–Schließt um 17:00",
  "Öffnungszeiten": "\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMontag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDienstag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMittwoch\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDonnerstag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFreitag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSamstag\n\t\t\t\t\n\t\t\t\t\tauf Anfrage\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSonntag\n\t\t\t\t\n\t\t\t\t\tGeschlossen\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFeiertage\n\t\t\t\t\n\t\t\t\t\tGeschlossen\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\tService nach Geschäftsschluss: nach Terminvereinbarung\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t",
  "Über_das_Unternehmen": "Seburger & Loske e.K. ist ein Meisterbetrieb mit spezialisiertem Fachpersonal. Selbstverständlich ist Seburger & Loske e.K. in allen Bereichen immer auf dem neuesten Stand der Technik. Deshalb nehmen unsere Mitarbeiter kontinuierlich an Weiterbildungen und Qualifizierungen teil und bauen Ihr fachliches Know-how für Sie ständig weiter aus."
}
```

Example 2

```json
{
  "Adresse": "Edigheimer Str. 47, ",
  "Anzahl_der_Bewertungen": "3 Bewertungen",
  "Bewertung": "4.3",
  "Branche": "TISCHLEREIEN",
  "E_Mail": "info@seburger-loske.de",
  "Fax": "0621 6 57 56-99",
  "Lead_url": "https://www.gelbeseiten.de/gsbiz/d9d55859-4610-4349-91b4-89d1a30bc315",
  "PLZ": "67069 ",
  "Standort": "Ludwigshafen am Rhein-Oppau",
  "Telefon": "\n\t\t\t 0621 65 75 60\n\t\t\t ",
  "Titel": "Seburger & Loske e.K.",
  "Website": "http://www.seburger-loske.de/",
  "Öffnungsstatus": "Jetzt geschlossen–Öffnet Mittwoch um 07:00",
  "Öffnungszeiten": "\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMontag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDienstag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMittwoch\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDonnerstag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFreitag\n\t\t\t\t\n\t\t\t\t\t07:00 – 12:3013:00 – 17:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSamstag\n\t\t\t\t\n\t\t\t\t\tauf Anfrage\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSonntag\n\t\t\t\t\n\t\t\t\t\tGeschlossen\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFeiertage\n\t\t\t\t\n\t\t\t\t\tGeschlossen\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\tService nach Geschäftsschluss: nach Terminvereinbarung\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t",
  "Über_das_Unternehmen": "Seburger & Loske e.K. ist ein Meisterbetrieb mit spezialisiertem Fachpersonal. Selbstverständlich ist Seburger & Loske e.K. in allen Bereichen immer auf dem neuesten Stand der Technik. Deshalb nehmen unsere Mitarbeiter kontinuierlich an Weiterbildungen und Qualifizierungen teil und bauen Ihr fachliches Know-how für Sie ständig weiter aus."
}
```

Example 3

```json
{
  "Adresse": "Verbindungskanal Linkes Ufer 22, ",
  "Anzahl_der_Bewertungen": "2 Bewertungen",
  "Bewertung": "5.0",
  "Branche": "TISCHLEREIEN",
  "E_Mail": "wohnen@robin-kruso.de",
  "Fax": "0621 10 55 17",
  "Lead_url": "https://www.gelbeseiten.de/gsbiz/d17a6c16-ba9d-4803-86e2-4e52317be607",
  "PLZ": "68159 ",
  "Standort": "Mannheim-Mühlauhafen",
  "Telefon": "\n\t\t\t 0621 1 70 26-26\n\t\t\t ",
  "Titel": "RobinKruso Handwerkergenossenschaft eG",
  "Website": "http://www.robinkruso.de/",
  "Öffnungsstatus": "Jetzt geschlossen–Öffnet Mittwoch um 08:30",
  "Öffnungszeiten": "\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMontag\n\t\t\t\t\n\t\t\t\t\t08:30 – 18:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDienstag\n\t\t\t\t\n\t\t\t\t\t08:30 – 18:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMittwoch\n\t\t\t\t\n\t\t\t\t\t08:30 – 18:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDonnerstag\n\t\t\t\t\n\t\t\t\t\t08:30 – 18:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFreitag\n\t\t\t\t\n\t\t\t\t\t10:00 – 18:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSamstag\n\t\t\t\t\n\t\t\t\t\t10:00 – 16:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t",
  "Über_das_Unternehmen": "Bau- und Möbelschreinerei. Fachgeschäft für ökologisches Bauen und Wohnen"
}
```

Example 4

```json
{
  "Adresse": "Luisenstr. 6, ",
  "Anzahl_der_Bewertungen": "1 Bewertung",
  "Bewertung": "5.0",
  "Branche": "PHYSIOTHERAPIE",
  "E_Mail": "info@aas-physiotherapie.de",
  "Fax": "0951 50 98 46 67",
  "Lead_url": "https://www.gelbeseiten.de/gsbiz/1d34baf3-3c6f-4346-8ea5-ff01f7e3b607",
  "PLZ": "96047 ",
  "Standort": "Bamberg",
  "Telefon": "\n\t\t\t 0951 50 98 46 68\n\t\t\t ",
  "Titel": "Aas Christoph Physiotherapeut",
  "Website": "https://www.aas-physiotherapie.de/",
  "Öffnungsstatus": "Jetzt geschlossen–Öffnet Montag um 08:00",
  "Öffnungszeiten": "\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMontag\n\t\t\t\t\n\t\t\t\t\t08:00 – 19:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDienstag\n\t\t\t\t\n\t\t\t\t\t08:00 – 19:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMittwoch\n\t\t\t\t\n\t\t\t\t\t08:00 – 19:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDonnerstag\n\t\t\t\t\n\t\t\t\t\t08:00 – 19:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFreitag\n\t\t\t\t\n\t\t\t\t\t08:00 – 19:00\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t",
  "Über_das_Unternehmen": ""
}
```

Example 5

```json
{
  "Adresse": "Promenadestr. 2, ",
  "Anzahl_der_Bewertungen": "2 Bewertungen",
  "Bewertung": "3.4",
  "Branche": "ÄRZTE: FACHÄRZTE FÜR INNERE MEDIZIN",
  "E_Mail": "praxis.dr.grewe@t-online.de",
  "Fax": "0951 20 09 60",
  "Lead_url": "https://www.gelbeseiten.de/gsbiz/37e21fc4-e4a1-428c-8d44-2b2236fd1b84",
  "PLZ": "96047 ",
  "Standort": "Bamberg",
  "Telefon": "\n\t\t\t 0951 20 09 65\n\t\t\t ",
  "Titel": "Dr. Eberhard Grewe Internist / Hausarzt",
  "Website": "https://sellwerk.de/firmenprofil/dr-eberhard-grewe",
  "Öffnungsstatus": "Jetzt geschlossen–Öffnet Montag um 08:00",
  "Öffnungszeiten": "\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMontag\n\t\t\t\t\n\t\t\t\t\t08:00 – 10:3013:30 – 15:30\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDienstag\n\t\t\t\t\n\t\t\t\t\t08:00 – 10:3013:30 – 15:30\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tMittwoch\n\t\t\t\t\n\t\t\t\t\t08:00 – 10:30\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tDonnerstag\n\t\t\t\t\n\t\t\t\t\t08:00 – 10:30\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tFreitag\n\t\t\t\t\n\t\t\t\t\t08:00 – 10:30\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSamstag\n\t\t\t\t\n\t\t\t\t\tRuhetag\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\tSonntag\n\t\t\t\t\n\t\t\t\t\tRuhetag\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\tund nach Vereinbarung\n\t\t\t\t\n\t\t\t\n\t\t\t\n\t\t\n\t",
  "Über_das_Unternehmen": "Ihr Facharzt für Innere Medizin in BambergDr. Eberhard Grewe ist Ihr kompetenter Internist und Hausarzt in Bamberg mit langjähriger Erfahrung in der inneren Medizin. Unsere Praxis bietet umfassende Dienstleistungen wie Ultraschall, Langzeit-EKG, Lungenfunktionstests sowie Diagnosen und Behandlungen von Hochdruckkrankheiten und Diabetes. Wir legen großen Wert auf persönliche Betreuung und effiziente hausärztliche Versorgung. Als zertifizierte Facharztpraxis sind wir Ihr Ansprechpartner für die Gesundheit Ihrer Schilddrüse, Gefäße und mehr. Kontaktieren Sie uns gerne für eine Terminvereinbarung."
}
```

## 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": "gelbe-seiten-scraper-nach-urls",
  "taskName": "Gelbe Seiten Scraper (by URLs with circles)",
  "parameters": "{\"listing_URLs\":[\"https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"listing_URLs\":[\"https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "gelbe-seiten-scraper-nach-urls",
        "taskName": "Gelbe Seiten Scraper (by URLs with circles)",
        "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": "gelbe-seiten-scraper-nach-urls",
  "taskName": "Gelbe Seiten Scraper (by URLs with circles)",
  "parameters": "{\"listing_URLs\":[\"https://www.gelbeseiten.de/suche/schreiner/mannheim?umkreis=20000\"]}"
}
JSON
```

## MCP Setup

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