🏢 Firmy Search Scraper

This actor allows you to scrape business listings from Firmy.cz by providing a search URL. It automatically handles pagination and extracts comprehensive company information including contact details, ratings, addresses, and business descriptions.

Features

• URL-based Scraping: Extract businesses by providing a complete Firmy.cz search URL
• Automatic Pagination: Automatically clicks through pages and loads more listings until reaching the end or max items limit
• Comprehensive Business Data: Extract detailed information about each business including:
  • Company name and ID
  • Full address with postal code, locality, and street address
  • Geographic coordinates (latitude and longitude)
  • Contact telephone numbers
  • Business descriptions and tags
  • Company logos and photos
  • Customer ratings and review counts
  • Opening hours information
  • External website links
  • Car offer links (for automotive businesses)

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete Firmy.cz search URL to scrape
maxItems	integer	No	Maximum number of businesses to fetch (default: unlimited)
proxyConfiguration	object	No	Proxy settings for the actor

How to Get Search URL

1. Go to Firmy.cz or Firmy.cz
2. Use the search filters or browse by category to find businesses
3. Copy the complete URL from your browser's address bar
4. Paste it into the searchUrl field

Example search URLs:

https://en.firmy.cz/Automotive
https://en.firmy.cz/Restaurants
https://www.firmy.cz/hledat?q=restaurace

Output

The output is a dataset of business listing objects, each containing:

• searchUrl: The original search URL used
• detailPageUrl: Direct link to the business detail page
• premiseId: Unique business identifier
• name: Company name
• address: Full address string
• postalCode: Postal/ZIP code
• locality: City and locality
• streetAddress: Street address
• latitude: Geographic latitude
• longitude: Geographic longitude
• telephone: Contact phone number
• description: Business description
• tags: Array of business category tags
• businessDescription: Detailed business description
• logoUrl: URL of the company logo
• photoUrl: URL of the business photo
• image: Main business image URL
• ratingValue: Average rating value
• ratingCount: Number of ratings
• ratingText: Rating text description
• ratingBadgeText: Rating badge text (e.g., "Very Good")
• reviewCount: Number of reviews
• openingInfo: Opening hours information
• webUrl: External website URL
• carOfferUrl: Car offer link (for automotive businesses)
• scrapedAt: Timestamp of when the listing was scraped

Example output:

[
  {
    "searchUrl": "https://en.firmy.cz/Automotive",
    "detailPageUrl": "https://en.firmy.cz/company/12973177-aaa-auto-praha-cimice.html",
    "premiseId": "12973177",
    "name": "AAA AUTO",
    "address": "Dopraváků 874/15, Praha, Čimice",
    "postalCode": "18400",
    "locality": "Praha, Čimice",
    "streetAddress": "Dopraváků 874/15",
    "latitude": 50.13685607910156,
    "longitude": 14.445097923278809,
    "telephone": "+420 284022450",
    "description": "Unbeatable choice, competitive prices, wide guarantees and convenient financing options. Over 19,000 quality and proven cars. Up to 36 months mechanical warranty, mileage check. Lifetime warranty of legal origin. Buying all makes and models, fair prices, cash immediately.",
    "tags": ["Automotive"],
    "businessDescription": "Unbeatable choice, competitive prices, wide guarantees and convenient financing options. Over 19,000 quality and proven cars. Up to 36 months mechanical warranty, mileage check. Lifetime warranty of legal origin. Buying all makes and models, fair prices, cash immediately.",
    "logoUrl": "https://d48-a.sdn.cz/d_48/c_img_E_G/OYsHuA.png?fl=res,48,48,1",
    "photoUrl": "https://d48-a.sdn.cz/d_48/c_img_QR_6/Xm6Frx.jpeg",
    "image": "https://d48-a.sdn.cz/d_48/c_img_QR_6/Xm6Frx.jpeg",
    "ratingValue": "86",
    "ratingCount": 4502,
    "ratingText": "",
    "ratingBadgeText": "",
    "reviewCount": "",
    "openingInfo": "today since 8:00",
    "webUrl": "http://www.aaaauto.cz/?utm_source=firmy.cz&bsw=251&utm_medium=katalog&utm_campaign=firmy.cz-praha&utm_content=kategorie-Auto%2dmoto",
    "carOfferUrl": "https://www.aaaauto.cz/ojete-vozy/?utm_source=firmy.cz&bsw=95&utm_medium=banner&utm_campaign=tlacitko-ojete-vozy-praha&utm_content=kategorie-Auto%2dmoto",
    "scrapedAt": "2025-11-10T07:58:34.771Z"
  },
  ...
]

Use Cases

• Business directory building
• Market research and competitor analysis
• Lead generation for B2B services
• Location-based business intelligence
• Contact information collection
• Business rating and review analysis
• Geographic business mapping
• Industry-specific business discovery

Notes

• The actor works with both English (en.firmy.cz) and Czech (firmy.cz) versions of the website
• Results are saved incrementally as they are found
• All timestamps are in ISO 8601 format
• Geographic coordinates are provided when available
• Rating information may vary depending on data availability
• External links may include tracking parameters

---

Start scraping business listings from Firmy.cz today!