Suche nach Europages-Lieferanten. 1 Credit pro Aufruf.
query ist ein Stichwort oder eine Kategorie- / Such-URL. domain wählt die Länderseite (fr Standard, de nutzt /de/suche/). page folgt /pg-N/.
Antwort: { results, pagination }. 30 Firmen pro Seite.
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
Beispiel (Stichwort):
verpackung
Beispiel (Such-URL):
https://www.europages.de/unternehmen/verpackung.html
query ist Pflicht.
| Form |
Beispiel |
Wirkung |
| Stichwort |
verpackung |
Suche auf der Site aus domain. Standard wäre https://www.europages.fr/fr/search/…. Mit domain=de: https://www.europages.de/de/suche/… |
| Kategorie- oder Such-URL |
https://www.europages.de/unternehmen/verpackung.html |
Der Host bleibt. Eine Firmen- oder Produkt-URL ergibt 400 |
Ein anderer Host ergibt 400. Ein leerer Wert ergibt 400.
domain ist die Site eines Stichworts. Werte: fr (Standard), de, co.uk (auch 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. Bei einer URL wird domain ignoriert. Deutsch nutzt den Pfad /de/suche/. Ein unbekannter Wert ergibt 400.
page startet bei 1. Unter 1: 400. Seite 2 und weiter nutzen /pg-N/ in der Listen-URL. Eine Seite hat 30 Unternehmen.
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Stichwort oder Europages-Kategorie- / Such-URL |
domain |
string |
nein |
Site eines Stichworts, zum Beispiel fr, de, co.uk. Standard fr |
page |
integer |
nein |
Seite ab 1. Weitere Seiten nutzen /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 |
- Eine Firmen- oder Produkt-URL liefert
400. Nutzen Sie Europages Company.
- Ältere Karten verlinken auf
/NAME/….html. company_id ist die Zahl in dieser URL. Europages Company akzeptiert sie und liefert die aktuelle Id der Seite.
- Keine Karten liefern
404.
| Code |
Bedeutung |
400 |
Leere Anfrage, unbekannter Host oder Firmen- / Produkt-URL |
403 |
Blockiert |
404 |
Keine Lieferanten |
500 |
Abruf fehlgeschlagen |
