API Allegro Search

API Allegro Search. Listings par mot-clé, numéro de page ou URL listing allegro.pl. Résultats avec prix, vendeurs, sponsorisation et pagination. 3 crédits par appel.

Actif3 crédits = 1 requêteGET/v2/allegro/search

Obtenir une clé API

Essayer l'endpoint gratuitement

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Essayer gratuitement

AperçuLink to Aperçu

L'API Allegro Search interroge les listings produits sur allegro.pl. Passez un mot-clé, une URL /listing complète, ou un mot-clé avec page, et recevez results[] + pagination en JSON.

Coût : 3 crédits par appel. Parse le JSON __listing_StoreState de la page de recherche Allegro.

Passez chaque listing_url à Allegro Product pour la fiche complète (3 crédits par appel).

Démarrage rapideLink to Démarrage rapide

GET https://api.piloterr.com/v2/allegro/search?query=mufowa
GET https://api.piloterr.com/v2/allegro/search?query=mufowa&page=2
GET https://api.piloterr.com/v2/allegro/search?query=https://allegro.pl/listing?string=mufowa
GET https://api.piloterr.com/v2/allegro/search?query=https://allegro.pl/listing?string=mufowa&p=2

ParamètresLink to Paramètres

Paramètre	Type	Requis	Description
`query`	string	oui	Mot-clé ou URL listing Allegro
`page`	integer	non	Numéro de page (défaut `1`). Remplace `p=` dans l'URL

Input formatsLink to Input formats

Format	Example	Notes
Keyword	`mufowa`	Resolves to page 1 (`/listing?string=mufowa`)
Keyword + `page`	`query=mufowa`, `page=2`	Appends `p=2` to the listing URL
Listing URL (page 1)	`https://allegro.pl/listing?string=mufowa`	Paste the URL copied from Allegro search
Listing URL (pagination)	`https://allegro.pl/listing?string=mufowa&p=2`	`p` in the URL selects the page

When both a listing URL and page are set, page overrides p= in the URL.

Response fieldsLink to Response fields

`results[]`Link to results[]

Field	Type	Description
`product_id`	string	Allegro product UUID
`offer_id`	string	Offer ID (numeric string)
`title`	string	Listing title
`listing_url`	string	Full offer or product URL on allegro.pl
`image_url`	string	Thumbnail image URL
`price`	number	Listed price
`currency`	string	Price currency (`PLN`)
`seller_id`	string	Seller account ID
`seller_name`	string	Seller display name
`position`	integer	Position on the SERP (0-based)
`is_sponsored`	boolean	`true` for sponsored placements
`delivery_info`	string	Delivery price snippet when shown

`pagination`Link to pagination

Field	Type	Description
`page`	integer	Current page number
`per_page`	integer	Listings returned on this page
`total_results`	integer	Total matching listings
`total_pages`	integer	Total pages available
`next`	string	Next page listing URL when available

Codes d'erreurLink to Codes d'erreur

Code	Signification
`400`	Entrée invalide ou URL non allegro.pl
`404`	Aucun listing trouvé
`500`	Erreur fetch ou parsing

NotesLink to Notes

Annonces organiques et sponsorisées (is_sponsored).
Caractères polonais supportés.
SERP vide → 404.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Tout voir

Allegro Product/v2/allegro/product

API Allegro Product. Données complètes de fiche produit allegro.pl par URL. Rendu navigateur, 3 crédits par appel. À combiner avec Allegro Search (3 crédits).

GET3 crédits = 1 requêteActif

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

+500 crédits
Aucune carte bancaire requise
Tous les endpoints inclus

Commencer gratuitement (+500 crédits)

Parler à un expert