Welcome To Firmy Scraper

💼 About Firmy.cz

Seznam.cz (or just Seznam, which means list in English) is a web portal and search engine in the Czech Republic. Founded in 1996 by Ivo Lukačovič in Prague as the first web portal in the Czech Republic. Seznam started with a search engine and an internet version of yellow pages. Today, Seznam runs almost 30 different web services and associated brands. Seznam had more than 6 million real users per month at the end of 2014.[4] Among the most popular services, according to NetMonitor, are its homepage seznam.cz, email.cz, search.seznam.cz and its yellow pages firmy.cz.

💼 Tutorial

👉 Parameters

Input	Type	Description
query	string	Query, Search Terms or URL
limit	integer	Number of results (per-query)

👉 Basic Usage

Search business

{ "query": "massage", "limit": 10 }

Autodetect Firmy URL for possible contents

{ "query": "https://www.firmy.com/?q=sponge bobs", "limit": 10 }

👉 Advanced Usage

FIRMY Query Language (FQL) :

[ [ <COMMAND:> | # | @ ] [ <NAME> | <ID> | <KEYWORD> ] [ / <SECTION> ] | <URL> ]

Possible QUERY values

Format	Example	Description
KEYWORD	square pants	Search Anything
<LISTING_ID>	13471952	Scrape Listing Data
/info	13471952/info	Business detail info
/reviews	13471952/reviews	Business reviews
/branches	13471952/branches	Business branches
https:<URL>	https://en.firmy.cz	Start URL
	https://en.firmy.cz/?q=massage

💼 Input Examples

... almost there ...

💼 Output Examples

👉 Business

1{
2    "addr_city": "Karviná, Staré Město",
3    "addr_house_num": "373/7",
4    "addr_street": "Bohumínská",
5    "addr_zip": "73301",
6    "address": "Bohumínská 373/7, 733 01  Karviná, Staré Město",
7    "anonymized": false,
8    "average_review_percentage": 84.198,
9    "can_have_request": true,
10    "categoryWeights": [],
11    "delivery_networks_data": {},
12    "description": "Car and commercial vehicle service, body shop, tire shop, car rental, auto glass replacement, towing service, 3D geometry, air conditioning repair, chiptuning, insurance claim settlement, accident service. Inspections without loss of warranty. Sale of original BMW, Audi, VW parts, OZONE disinfection.",
13    "enabled": true,
14    "exact_match": false,
15    "filters_name": [
16        "Card payment",
17        "Nonstop emergency"
18    ],
19    "gps_encode": "9q55IxWiOH",
20    "gps_latitude": 49.86497497558594,
21    "gps_longitude": 18.515583038330078,
22    "has_opening_time": true,
23    "id": 12845783,
24    "images": [
25        {
26            "big": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg",
27            "description": {
28                "id": 991135,
29                "metadata": {
30                    "size": [
31                        2592,
32                        1726
33                    ]
34                },
35                "source": "firmy_userweb",
36                "type": "mphoto",
37                "visits": 2055
38            },
39            "full": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,600,400,3,ffffff",
40            "gallery": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,250,167,3,ffffff",
41            "half": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,300,200,3,ffffff",
42            "hintGallery": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,1200,900,1",
43            "hintThumbMedium": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,600,400,3",
44            "hintThumbSmall": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,300,200,3",
45            "list": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,220,147,3,ffffff",
46            "mapcircle": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,59,59,3,ffffff",
47            "medium": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,600,450,1,ffffff",
48            "noborder": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,600,450,3,ffffff",
49            "orig": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg",
50            "small": "https://d48-a.sdn.cz/d_48/c_img_H_D/4nhn51.jpeg?fl=res,112,84,1,ffffff"
51        }
52    ],
53    "imported_data": null,
54    "is_paid": true,
55    "is_paid_or_noncom": true,
56    "logos_url": [
57        {
58            "big": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png?fl=res,140,140,3,ffffff",
59            "description": {
60                "id": 1446349,
61                "metadata": {
62                    "size": [
63                        140,
64                        140
65                    ]
66                },
67                "source": "firmy_adminweb",
68                "type": "logo"
69            },
70            "email": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png",
71            "form": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png",
72            "medium": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png?fl=res,120,120,1,ffffff",
73            "orig": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png",
74            "small": "https://d48-a.sdn.cz/d_48/c_img_H_D/jcgBX65.png?fl=res,70,70,1,ffffff"
75        }
76    ],
77    "main_offer_type": "",
78    "offers": [],
79    "opening_time_additional_info": "Sobota pro firemní zákazníky po dohodě.",
80    "opening_time_today": {
81        "additional_info": "Sobota pro firemní zákazníky po dohodě.",
82        "amEnd": {
83            "hour": 16,
84            "minute": 45
85        },
86        "amStart": {
87            "hour": 7,
88            "minute": 45
89        },
90        "date": "2022-10-21",
91        "day": "friday",
92        "exception_id": "",
93        "nonstop": false,
94        "relative_sort": 0,
95        "specification_id": "open"
96    },
97    "phone": {
98        "country_code": "420",
99        "number": "596322020",
100        "role": "Phone"
101    },
102    "region_district_name": "Karviná",
103    "review_count": 9,
104    "seo_name": "bosch-car-service-cru-servis-karvina-karvina-stare-mesto",
105    "stars": 4,
106    "subject_id": 3835170,
107    "title": "CRU Servis",
108    "title_addition": ", s.r.o.",
109    "title_alternative": "BOSCH CAR SERVICE - CRU Servis Karviná",
110    "title_alternative_web": "",
111    "title_use_alternative": true,
112    "title_web": "BOSCH CAR SERVICE - CRU Servis Karviná",
113    "url": "http://www.cruservis.cz",
114    "zbozi_premise_id": 0
115}

💼 Support

⚡️ Feel free to reach out to the developer for any issues or suggestions for improvement.