# Golocal Leads Scraper

Scrape leads data like email, telephone numbers, address, etc. from Golocal.de by listing urls.

- Template page: [https://www.octoparse.com/template/golocal-leads-scraper](https://www.octoparse.com/template/golocal-leads-scraper)
- 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 listing pages, detail pages.

## Output

The current workflow extracts 11 fields, including `Addresse_Ort`, `Adresse_Straße`, `Anzahl_der_Rezensionen`, `Detail_url`, `Email`, `Kategorie`, `Kundenbewertung`, `Postleitzahl`, `Telefonnummer`, `Titel`, `Website`.

## 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 (up to 100), Number of Pages (up to 1000) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Listing URLs (up to 100)

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

### Number of Pages (up to 1000)

Optional. Number of Pages (up to 1000) Constraints: minimum=1, maximum=1000.

## How to Use

## Golocal Leads Scraper

Collects leads data (email, telephone, address, etc.) from Golocal.de by listing URLs.

**Pricing:** No per-line charge.

**Input:**
- **Listing URLs (up to 100)** (required): Enter one per line.
- **Number of Pages (up to 1000)** (optional): Enter a number from 1 to 1000.

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

**Limitations:**
- Collects only fields displayed on listing pages; does not add data not shown.
- Fields such as Email, Website, and Detail_url can be empty if not provided.

**Tips:**
- Start with a few inputs and review results before scaling.
- Use specific valid listing URLs to reduce unrelated/duplicate records.
- Use a stable URL or identifier from the results 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

- [Golocal Reviews Scraper](https://www.octoparse.com/template/golocal-bewertungen-scraper)
- [Google Maps Leads Scraper](https://www.octoparse.com/template/google-maps-scraper-store-details-by-keyword)
- [Kompass Leads Scraper (for Germany)](https://www.octoparse.com/template/kompass-leads-scraper)
- [Kununu.com Leads Scraper](https://www.octoparse.com/template/kununucom-leads-scraper)
- [Marktplazt Mittelstand Leads Scraper](https://www.octoparse.com/template/marktplazt-mittelstand-leads-scraper)

## Input Schema

```json
{
  "title": "Golocal Leads Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "listing_URLs": {
      "title": "Listing URLs (up to 100)",
      "description": "Listing URLs (up to 100)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_Pages": {
      "title": "Number of Pages (up to 1000)",
      "description": "Number of Pages (up to 1000)",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "listing_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "listing_URLs": [
    "https://www.golocal.de/suchen/?q=location&what=Buchhandel&rad=10.0&ri=3&order=bypointsanddistance&address=Bielefeld+&dsActive=false&ds=true&dsCity=Bielefeld&dsCitykey=05711000000&searchType=city&xc=8.542125949999994&yc=52.02125591697363"
  ]
}
```

Example 2

```json
{
  "listing_URLs": [
    "https://www.golocal.de/suchen/?q=location&what=Buchhandel&rad=10.0&ri=3&order=bypointsanddistance&address=Bielefeld+&dsActive=false&ds=true&dsCity=Bielefeld&dsCitykey=05711000000&searchType=city&xc=8.542125949999994&yc=52.02125591697363"
  ]
}
```

Example 3

```json
{
  "listing_URLs": [
    "https://www.golocal.de/suchen/?q=location&what=arzt&address=bamberg"
  ],
  "number_of_Pages": 10
}
```

Example 4

```json
{
  "listing_URLs": [
    "https://www.golocal.de/suchen/?q=location&what=physiotherapie&address=bamberg"
  ],
  "number_of_Pages": 10
}
```

Example 5

```json
{
  "listing_URLs": [
    "https://www.golocal.de/suchen/?q=location&what=zahnarzt&address=bamberg"
  ],
  "number_of_Pages": 10
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Addresse_Ort": {
      "type": "string",
      "description": ""
    },
    "Adresse_Straße": {
      "type": "string",
      "description": ""
    },
    "Anzahl_der_Rezensionen": {
      "type": "string",
      "description": ""
    },
    "Detail_url": {
      "type": "string",
      "description": ""
    },
    "Email": {
      "type": "string",
      "description": ""
    },
    "Kategorie": {
      "type": "string",
      "description": ""
    },
    "Kundenbewertung": {
      "type": "string",
      "description": ""
    },
    "Postleitzahl": {
      "type": "string",
      "description": ""
    },
    "Telefonnummer": {
      "type": "string",
      "description": ""
    },
    "Titel": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Golocal Leads Scraper 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
{
  "Addresse_Ort": "Bielefeld",
  "Adresse_Straße": "Hagenbruchstr. 7",
  "Anzahl_der_Rezensionen": "1",
  "Detail_url": "https://www.golocal.de/bielefeld/buchhandlungen/eulenspiegel-buchladen-karo-buchvertriebsg-mbh-ZAHZP/",
  "Email": "Buch_eulenspiegel@gmx.de",
  "Kategorie": "Buchhandlungen",
  "Kundenbewertung": "5.0",
  "Postleitzahl": "33602",
  "Telefonnummer": "(0521) 17 50 49",
  "Titel": "Eulenspiegel Buchladen Karo Buchvertriebsg. mbH",
  "Website": "https://www.buchladen-eulenspiegel.de/"
}
```

Example 2

```json
{
  "Addresse_Ort": "Bielefeld Windelsbleiche",
  "Adresse_Straße": "Windelsbleicher Str. 237",
  "Anzahl_der_Rezensionen": "1",
  "Detail_url": "https://www.golocal.de/bielefeld/buchhandlungen/exlibris-buchhandel-9uKPv/",
  "Email": "info@exlibris-senne.de",
  "Kategorie": "Buchhandlungen",
  "Kundenbewertung": "5.0",
  "Postleitzahl": "33659",
  "Telefonnummer": "(0521) 948 51 54",
  "Titel": "Exlibris Buchhandel",
  "Website": "http://www.buchhandlung-exlibris.de/"
}
```

Example 3

```json
{
  "Addresse_Ort": "Bamberg",
  "Adresse_Straße": "Willy-Lessing-Str. 12",
  "Anzahl_der_Rezensionen": "10",
  "Detail_url": "https://www.golocal.de/bamberg/fachaerzte-fuer-allgemeinmedizin/dr-med-maktabi-saladin-lungen-bronchialheilkunde-M35Er/",
  "Email": "drmaktabi@t-online.de",
  "Kategorie": "Fachärzte für Allgemeinmedizin",
  "Kundenbewertung": "5.0",
  "Postleitzahl": "96047",
  "Telefonnummer": "(0951) 238 39",
  "Titel": "Dr. med. Maktabi Saladin Lungen- und Bronchialheilkunde",
  "Website": "http://www.maktabi.de/"
}
```

Example 4

```json
{
  "Addresse_Ort": "Bamberg",
  "Adresse_Straße": "Adolf-Wächter-Str. 4",
  "Anzahl_der_Rezensionen": "2",
  "Detail_url": "https://www.golocal.de/bamberg/physiotherapie/physix-physiotherapie-sportwissenschaft-11Xggu/",
  "Email": "info@physix.de",
  "Kategorie": "Physiotherapie\n, \nGesundheitswesen",
  "Kundenbewertung": "5.0",
  "Postleitzahl": "96052",
  "Telefonnummer": "(0951) 16 09 61 76",
  "Titel": "PHYSIX - Physiotherapie und Sportwissenschaft",
  "Website": "https://www.physix.de/"
}
```

Example 5

```json
{
  "Addresse_Ort": "Bamberg",
  "Adresse_Straße": "Grüner Markt 20",
  "Anzahl_der_Rezensionen": "53",
  "Detail_url": "https://www.golocal.de/bamberg/zahnaerzte/zahnarztpraxis-dr-horst-stoecker-4iDkZ/",
  "Email": "post@praxis-dr-stoecker.de",
  "Kategorie": "Zahnärzte",
  "Kundenbewertung": "4.9",
  "Postleitzahl": "96047",
  "Telefonnummer": "(0951) 260 92",
  "Titel": "Zahnarztpraxis Dr. Horst Stöcker",
  "Website": "http://www.praxis-dr-stoecker.de/"
}
```

## 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": "golocal-leads-scraper",
  "taskName": "Golocal Leads Scraper",
  "parameters": "{\"listing_URLs\":[\"https://www.golocal.de/suchen/?q=location&what=Buchhandel&rad=10.0&ri=3&order=bypointsanddistance&address=Bielefeld+&dsActive=false&ds=true&dsCity=Bielefeld&dsCitykey=05711000000&searchType=city&xc=8.542125949999994&yc=52.02125591697363\"]}"
}
```

## 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.golocal.de/suchen/?q=location&what=Buchhandel&rad=10.0&ri=3&order=bypointsanddistance&address=Bielefeld+&dsActive=false&ds=true&dsCity=Bielefeld&dsCitykey=05711000000&searchType=city&xc=8.542125949999994&yc=52.02125591697363\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "golocal-leads-scraper",
        "taskName": "Golocal Leads Scraper",
        "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": "golocal-leads-scraper",
  "taskName": "Golocal Leads Scraper",
  "parameters": "{\"listing_URLs\":[\"https://www.golocal.de/suchen/?q=location&what=Buchhandel&rad=10.0&ri=3&order=bypointsanddistance&address=Bielefeld+&dsActive=false&ds=true&dsCity=Bielefeld&dsCitykey=05711000000&searchType=city&xc=8.542125949999994&yc=52.02125591697363\"]}"
}
JSON
```

## MCP Setup

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