L'API Point.P Search retourne les listings produit depuis les pages de recherche Point.P. Passez un mot-clé (ex. colle) ou une URL complète et recevez titres, prix, marques, notes, unités et pagination en JSON.
Piloterr utilise le rendu navigateur pour charger la page et extraire les fiches produit.
Utilisez chaque listing_url avec Point.P Product pour le PDP complet (description, EAN, spécifications, fil d'Ariane).
GET https://api.piloterr.com/v2/pointp/search?query=colle
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
Mot-clé ou URL de recherche Point.P |
page |
integer |
non |
Numéro de page (1-based). Remplace la page déduite de l'URL |
return_page_source |
boolean |
non |
HTML brut en {"result": "..."} (défaut : false) |
| Champ |
Type |
Toujours présent |
Description |
product_id |
string |
oui |
ID Point.P préfixé A (ex. A7147449) |
reference |
string |
non |
Réf affichée sur la card (≠ product_id) |
title |
string |
oui |
Titre produit |
listing_url |
string |
oui |
URL absolue /p/...-A{id} |
image_url |
string |
non |
Miniature |
brand |
string |
non |
Marque |
price |
number |
non |
Prix ; null si « selon agence » |
currency |
string |
non |
Code ISO 4217 (EUR) si price renseigné |
rating |
number |
non |
Note sur 5 (1 décimale) |
review_count |
integer |
non |
Nombre d'avis |
unit |
string |
non |
Unité de vente |
| Champ |
Type |
Description |
page |
integer |
Page courante |
per_page |
integer |
Listings sur la page (typ. 24) |
total_results |
integer |
Total produits |
total_pages |
integer |
Nombre de pages |
next |
string | null |
URL page suivante ; null sur la dernière page |
- Search: découvrir les listings (cet endpoint)
- Product: récupérer le PDP depuis une
listing_url
product_id et reference sont deux identifiants distincts.- Coût : 2 crédits par appel (rendu navigateur).
