Search Europages suppliers. 1 credit per call.
query is a keyword (emballage) or a category / search URL (/entreprises/…html, /fr/search/emballage). domain picks the country site when query is a keyword (fr by default, de, co.uk, es, it, …). page uses the site pagination /pg-N/.
Response shape: { results, pagination }. A page holds 30 companies.
GET https://api.piloterr.com/v2/europages/search?query=emballage
GET https://api.piloterr.com/v2/europages/search?query=https://www.europages.fr/entreprises/emballage-blister-plastique.html&page=2
Example (keyword):
emballage
Example (search URL):
https://www.europages.fr/entreprises/emballage-blister-plastique.html
query is required.
| Form |
Example |
What happens |
| Keyword |
emballage |
Search on the site chosen by domain. Default https://www.europages.fr/fr/search/emballage |
| Category or search URL |
https://www.europages.fr/entreprises/emballage-blister-plastique.html |
The host is kept. A company URL or a product URL returns 400 |
Another host returns 400. An empty value returns 400.
domain is the site of a keyword. Values: fr (default), de, co.uk (also en, uk, gb), es, it, nl, com.tr (tr), cz (cs), dk, ee, gr, lt, co.hu, no, pl, pt, ro, si, fi, se, bg. It is ignored when query is a URL. German uses the path /de/suche/. An unknown value returns 400.
page starts at 1. Below 1 returns 400. Page 2 and after use /pg-N/ on the listing URL. A page holds 30 companies.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword, or a Europages category / search URL |
domain |
string |
no |
Site of a keyword, such as fr, de, co.uk. Default fr |
page |
integer |
no |
Page from 1. Later pages use /pg-N/ |
| Field |
Type |
Description |
results[] |
array |
Company cards |
results[].position |
integer |
Position on the page, from 1 |
results[].company_id |
string | null |
Numeric id from the profile URL |
results[].name |
string |
Company name |
results[].url |
string |
Profile URL for the company endpoint |
results[].country |
string | null |
Country |
results[].city |
string | null |
City |
results[].founding_year |
integer | null |
Year on the card |
results[].employees |
string | null |
Range such as 20-49 |
results[].delivery_area |
string | null |
Delivery area |
results[].supplier_types |
string[] |
Manufacturer, wholesaler, and similar labels |
results[].description |
string | null |
Short text |
pagination.page / per_page |
integer |
Page and page size (30) |
pagination.total_results / total_pages |
integer | null |
Totals when the page shows them |
pagination.next |
string | null |
Next page URL |
- A company or product URL passed here returns
400. Use Europages Company.
- Older cards link to
/NAME/….html. company_id is the number in that URL. Europages Company accepts it and returns the current id from the page.
- No cards returns
404.
- German keywords use
/de/suche/{keyword}. Other sites use /{language}/search/{keyword}.
| Code |
Meaning |
400 |
Missing query, unknown host, or a company / product URL |
403 |
Blocked |
404 |
No suppliers |
500 |
Fetch failed |
