Allegro Search
Search for products across Allegro, Poland's leading e-commerce marketplace, and retrieve structured product listings.
Credit cost: 2 credits per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
Search keyword to look up products on Allegro, Poland's largest marketplace.
Example:
Karty pokemonNotes:
- Supports Polish characters — diacritics such as
ż,ę,óare handled correctly. - Results may include sponsored and promoted listings alongside organic results.
- The more specific your keyword, the more targeted the results.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/allegro/search?query=string"[
{
"id": "07cddd1b-1c58-4319-b73f-be4b4ebb1168",
"url": "https://allegro.pl/produkt/karty-pokemon-360-kart-mega-box-w-tym-specjalne-07cddd1b-1c58-4319-b73f-be4b4ebb1168",
"name": "KARTY POKEMON 360 KART MEGA BOX W TYM SPECJALNE",
"slug": "/karty-pokemon-360-kart-mega-box-w-tym-specjalne-07cddd1b-1c58-4319-b73f-be4b4ebb1168",
"image": "https://a.allegroimg.com/s48b/11c040/4cef7dc545169cf7a62d25709656"
},
{
"id": "c9361e92-91f2-4fb5-973e-0e22ff492f6c",
"url": "https://allegro.pl/produkt/karty-kolekcjonerskie-pokemon-teczowe-rainbow-55-c9361e92-91f2-4fb5-973e-0e22ff492f6c",
"name": "KARTY KOLEKCJONERSKIE POKEMON TĘCZOWE RAINBOW 55",
"slug": "/karty-kolekcjonerskie-pokemon-teczowe-rainbow-55-c9361e92-91f2-4fb5-973e-0e22ff492f6c",
"image": "https://a.allegroimg.com/s48b/11d4ce/ea27e19a4616a7e4d858b9147db5"
},
{
"id": "172a205c-1499-46f0-aadb-edfb4df719cb",
"url": "https://allegro.pl/produkt/klaser-album-na-240-karty-pokemon-gratis-karty-172a205c-1499-46f0-aadb-edfb4df719cb",
"name": "KLASER ALBUM NA 240 KARTY POKEMON + GRATIS KARTY",
"slug": "/klaser-album-na-240-karty-pokemon-gratis-karty-172a205c-1499-46f0-aadb-edfb4df719cb",
"image": "https://a.allegroimg.com/s48b/11f1bf/33e8bf954cb29a3d6c5c435e5cfe"
}
]{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}