Herold API

Search HEROLD, Austria's yellow pages, and pull business contacts, opening hours and reviews as JSON.

The API.SH Herold API turns herold.at, Austria's yellow pages, into structured JSON. Search businesses by trade or keyword, optionally in a place, and get name, description, address, phone, email, website, rating, review count and verified flag, 30 a page with the total. Then open a business for every category, coordinates, opening hours per day, company details such as founding year and employees, services by group, payment methods, photos 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

Search Austrian businesses

GET https://api.api.sh/herold/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Herold API

Austrian B2B lead lists

Search a trade such as Installateur in Wien and collect business phone, email, website and address for outreach in Austria.

/search

Company profile enrichment

Open each business for founding year, employee count, services and categories to enrich CRM records.

/business

Local listing audits

Check that your locations on HEROLD show the right address, opening hours, categories and contact links.

/business

Reputation monitoring

Pull ratings, review counts and the reviews shown for your business and competitors across Austrian cities.

/search /business

Herold data you get

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

Herold API endpoints and prices

Every Herold 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

Search Austrian businesses

/herold/v1/search

$1 · $2 PAYG

1 credit

More data1

HEROLD business details

/herold/v1/business

$1 · $2 PAYG

1 credit

Call the Herold API

Search Austrian businesses: GET https://api.api.sh/herold/v1/search

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

import os, requests

res = requests.get(
    "https://api.api.sh/herold/v1/search",
    params={"q": "restaurant"},
    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/herold/v1/search");
url.searchParams.set("q", "restaurant");

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("/herold/v1/search", "q", "restaurant")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Herold" and "Search Austrian businesses".

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

Public data only: no Herold login, cookies or account needed
One key and one response shape for Herold 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 Herold API

HEROLD does not publish a public data API for its business directory. API.SH reads public herold.at business pages and returns them as JSON.

Instead of running an Octoparse template or your own Herold scraper, call two endpoints with one API.SH key at a fixed price per call.

Herold API questions

What Herold data can I get?+

Business search by trade or keyword in a place with the total count (/herold/v1/search), and one business with categories, address, coordinates, contacts, opening hours, company details, services, payment methods, photos and reviews (/herold/v1/business).

How much does the Herold API cost?+

Every Herold 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 /herold/v1/business at 1 credit each.

Is there an official Herold API?+

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

Do I need a Herold account or login?+

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

Is this the Herald API?+

No. Searches for "herold api" often show Herald, an insurance API, and other similar names. This page is about HEROLD, the Austrian business directory at herold.at.

Does it include the Herold Telefonbuch for private people?+

No. Only business listings are covered, not private people's phone book entries or reverse number lookup.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /herold/v1/search with q set to Tischler and location set to Graz. 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.