Gelbe Seiten API

Search Gelbe Seiten, Germany's yellow pages, and pull business contacts, opening hours and reviews as JSON.

The API.SH Gelbe Seiten API turns gelbeseiten.de, the German yellow pages, into structured JSON. Search businesses for a trade or name in a place, with a radius or related trades, and get each one's category, address, distance, phone, website, rating, review count and open-now flag, 50 a page. Then open a business for its email, fax, opening hours per day, payment methods, services, trades, languages, social links, rating sources and the reviews shown.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Gelbe Seiten business search

GET https://api.api.sh/gelbe-seiten/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Gelbe Seiten API

German B2B lead lists

Search a trade such as Elektriker in a city with a radius and collect business name, phone, website and address for outreach.

/search

Contact enrichment

Open each business to add its business email, fax, opening hours, social links and services to your CRM records.

/business

Local SEO audits

Check how your branches appear on Gelbe Seiten: categories, trades, address, opening hours and website.

/search /business

Review monitoring

Pull ratings, rating sources and the reviews shown for your business and nearby competitors.

/business

Local market sizing

Use the total match count and distances for a trade in each city to compare how many providers serve each area.

/search

Gelbe Seiten data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Gelbe Seiten API endpoints and prices

Every Gelbe Seiten endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Gelbe Seiten business search

/gelbe-seiten/v1/search

$1 · $2 PAYG

1 credit

More data1

Gelbe Seiten business detail

/gelbe-seiten/v1/business

$1 · $2 PAYG

1 credit

Call the Gelbe Seiten API

Gelbe Seiten business search: GET https://api.api.sh/gelbe-seiten/v1/search

curl "https://api.api.sh/gelbe-seiten/v1/search?q=zahnarzt" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/gelbe-seiten/v1/search",
    params={"q": "zahnarzt"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/gelbe-seiten/v1/search");
url.searchParams.set("q", "zahnarzt");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/gelbe-seiten/v1/search", "q", "zahnarzt")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Gelbe Seiten" and "Gelbe Seiten business search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Gelbe Seiten data

Public data only: no Gelbe Seiten login, cookies or account needed
One key and one response shape for Gelbe Seiten and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Gelbe Seiten API

Gelbe Seiten does not publish a public data API; listing services such as Yext only push business entries into it. API.SH reads public gelbeseiten.de pages and returns them as JSON.

Octoparse templates, browser extensions and GitHub projects like yellowscrape need manual runs and break when the site changes. API.SH gives you two endpoints with one key at a fixed price per call.

Gelbe Seiten API questions

What Gelbe Seiten data can I get?+

Business search by trade or name in a place, with radius and related trades (/gelbe-seiten/v1/search), and one business with contacts, email, opening hours, payment methods, services, trades, social links, ratings and reviews (/gelbe-seiten/v1/business).

How much does the Gelbe Seiten API cost?+

Every Gelbe Seiten endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /gelbe-seiten/v1/business at 1 credit each.

Is there an official Gelbe Seiten API?+

No public data API turned up in our research. API.SH covers the public business listings on gelbeseiten.de.

Do I need a Gelbe Seiten account or login?+

No. API.SH reads public Gelbe Seiten pages only. No endpoint uses a login, cookies or anyone's account.

How can I scrape data from Gelbe Seiten?+

Instead of writing a scraper, call /gelbe-seiten/v1/search for lists and /gelbe-seiten/v1/business for details. You get JSON, pagination with next_page, and blocks and retries are handled for you. Follow the site's terms and GDPR when you use business contacts.

Does it include private persons (Personensuche)?+

No. The API covers business listings only, not private people's phone book entries.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /gelbe-seiten/v1/search with q set to Zahnarzt and location set to Berlin. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.