Gulesider Scraper

Scrape Gulesider.no — Norway's leading business and phone directory. Search by category/keyword and city (or nationwide across all of Norway), or fetch full business profiles by direct URL or business ID. Get names, addresses, phone numbers, categories, ratings, review counts, opening hours, websites, organization numbers, founding dates, VAT status, coordinates, and images. No auth, no cookies, no paid proxy required.

What this actor does

• Two modes: search (category/keyword + city) and detail (direct URL/ID lookup)
• Nationwide, city-scoped, or category-only search: search by category, by city alone, or both together
• Rich business profiles: optional detail-page enrichment adds rating, review count, opening hours, description, coordinates, organization number, founding date, VAT registration status, and social media links
• Search-page enrichment: website, online booking/ordering links, and "confirmed info" verification status are picked up directly from search results, no extra page visit required
• Filters: minimum rating, ratings-only, website-only, confirmed-info-only, sort by relevance/rating/name
• Norwegian-localized opening hours: day names in Norwegian (Mandag, Tirsdag, ...)
• Empty fields are omitted — you'll never see null, "", or [] in the output

Output per business

• businessId — Gulesider's internal numeric business ID
• name — business name
• businessType — schema.org business type (e.g. Restaurant, HairSalon, Dentist)
• category, categories[] — Gulesider's category taxonomy chain (detail pages only)
• street, postalCode, city, region, country — postal address
• phone — phone number
• email — business email (detail pages only, when Gulesider lists one)
• website — business website (search results for businesses that show one, or detail pages)
• bookingUrl — online ordering/booking link, if the business has one (search results only)
• isVerified — whether the business has confirmed its own listing information with Gulesider (search results only)
• description — short business description (detail pages only)
• rating, reviewCount — average customer rating (1–5) and number of reviews (detail pages only)
• openingHours[] — structured weekly schedule: { day, opens, closes } with Norwegian day names
• openingHoursText — human-readable summary of the weekly schedule
• latitude, longitude — geographic coordinates (detail pages only)
• mapUrl — Gulesider directions/map link
• logoUrl — business logo image URL (detail pages only)
• images[] — business photo gallery (detail pages only)
• orgNumber — Norwegian organization number (Brønnøysundregistrene), when registered (detail pages only)
• foundingDate — company founding date, format DD.MM.YYYY (detail pages only, when available)
• employeeRange — reported employee count range, e.g. "1 - 4" (detail pages only, when available)
• vatRegistered — whether the business is VAT-registered (detail pages only, when available)
• socialLinks[] — social media profile URLs, e.g. Facebook (detail pages only, when available)
• searchQuery, searchCity — the query/city that produced this result (mode=search only)
• sourceUrl — canonical Gulesider business page URL
• recordType: "business", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / detail
query	string	pizza	Category/keyword, pick from list or choose "Custom" (mode=search)
customQuery	string	–	Free-text category/keyword, overrides query (mode=search)
city	string	Oslo	Norwegian city; leave empty for nationwide search (needs a category)
sortBy	string	relevance	relevance / rating / name
minRating	string	–	Minimum star rating (1–5); needs fetchDetails
ratedOnly	boolean	false	Only businesses with at least one rating; needs fetchDetails
hasWebsiteOnly	boolean	false	Only businesses with a listed website
verifiedOnly	boolean	false	Only businesses that confirmed their own listing info
fetchDetails	boolean	false	Visit each business's profile page for rating, hours, org data, coordinates
businessUrls	array	–	Gulesider business URLs or numeric IDs to fetch (mode=detail)
maxItems	integer	50	Hard cap on returned records (1–1000)

Example: search a category in a city

{
  "mode": "search",
  "query": "frisør",
  "city": "Bergen",
  "maxItems": 50
}

Example: nationwide search with full profiles

{
  "mode": "search",
  "customQuery": "veterinær",
  "city": "",
  "fetchDetails": true,
  "minRating": "4",
  "maxItems": 30
}

Example: top-rated, confirmed listings only, sorted

{
  "mode": "search",
  "query": "restaurant",
  "city": "Trondheim",
  "fetchDetails": true,
  "ratedOnly": true,
  "verifiedOnly": true,
  "sortBy": "rating",
  "maxItems": 40
}

Example: all businesses in a city (no category)

{
  "mode": "search",
  "query": "custom",
  "customQuery": "",
  "city": "Stavanger",
  "maxItems": 50
}

Example: fetch specific business profiles

{
  "mode": "detail",
  "businessUrls": [
    "https://www.gulesider.no/dinos+pizza+oslo/84424493/bedrift",
    "84424493"
  ]
}

Use cases

• Lead generation — build prospect lists of Norwegian businesses by category and city
• Market research — analyze business density and ratings across Norwegian regions
• Local SEO agencies — audit client and competitor directory listings
• Data enrichment — append verified phone numbers, addresses, org numbers, and websites to a CRM
• Franchise/expansion planning — map existing competitor locations before entering a new city

FAQ

What is the data source? All data comes from the public Gulesider.no website, Norway's largest business and phone directory, operated by Eniro Norge AS.

Is this affiliated with Gulesider? No — this is an independent, third-party actor that reads Gulesider's public listing pages. It is not affiliated with or endorsed by Eniro Norge AS or Gule Sider AS.

Why are rating, openingHours, orgNumber, and other detail fields sometimes missing? Those fields only appear on a business's full profile page. Enable fetchDetails to fetch them — without it, only the fields visible directly on the search-results page are returned (name, address, phone, category type, and — for some listings — website, booking link, and confirmed-info status).

Can I search all of Norway at once? Yes — leave city empty and provide a category/keyword; the search covers the entire country.

Can I search a city with no category? Yes — set query to "Custom" with an empty custom field (or just enter a category value of your choice) and set only city; Gulesider returns all businesses in that city.

Why don't orgNumber, foundingDate, employeeRange, vatRegistered, and socialLinks appear on every business? Gulesider only publishes this firmographic data for businesses with a registered Norwegian organization number (Brønnøysundregistrene). Informal or unregistered listings won't have it.

What Norwegian weekday names are used in openingHours? Mandag, Tirsdag, Onsdag, Torsdag, Fredag, Lørdag, Søndag (Monday–Sunday).

Does the actor return individual written reviews? No — Gulesider's business pages expose an aggregate rating and reviewCount but not per-review text, so only the aggregate figures are included.

How fresh is the data? Each run scrapes Gulesider's live pages in real time, so results reflect the current state of the directory.

What happens if my category/keyword doesn't match any real Gulesider category? Gulesider's own search does not strictly require an exact keyword match — for a keyword it doesn't recognize, it may still return a broader set of businesses for the given city rather than zero results. This is upstream Gulesider search behavior, not an actor bug; using one of the curated category options (or a real Norwegian business term with correct æ/ø/å spelling) gives the most precise results.

Why does a website or socialLinks URL sometimes not load when I check it programmatically? The URLs themselves are correct as listed by Gulesider. Two upstream behaviors can make a URL check fail even though the link is valid: (1) a business's own website can be temporarily down or slow to respond, which is outside Gulesider's and this actor's control; (2) Facebook systematically returns 400/404 to unauthenticated, non-browser HTTP requests for profile/page URLs (confirmed even against Gulesider's own official Facebook page) — the link opens normally in an actual browser.

Does the actor return a separate "map"/"near me" search mode? No — mode=search and mode=detail already return each business's latitude/longitude and mapUrl, which is the same underlying data Gulesider's map view displays; a separate map mode would return the identical business data through a different UI, so it isn't exposed as its own mode.