The Allegro Search API queries product listings on allegro.pl, Poland's largest e-commerce marketplace. Pass a keyword, a full /listing URL, or a keyword with page, and receive structured JSON with results[] and pagination.
Costs 3 credits per call. Parses Allegro's __listing_StoreState JSON from the rendered search page.
Pass each listing_url to Allegro Product for full PDP data (3 credits per call).
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
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Search keyword or full Allegro listing URL (/listing?string=…) |
page |
integer |
no |
Page number (default 1). Overrides p= in a listing URL |
| 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.
| 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 |
| 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 |
| Code |
Meaning |
400 |
Empty or invalid query, or non-allegro.pl URL |
404 |
No listings found for the search |
500 |
Page fetch or parse error |
- Results include organic and sponsored listings (
is_sponsored).
- Polish characters (ą, ę, ó, ż, etc.) are fully supported in keywords.
- Banner rows (e.g. best-price guarantee) are filtered out of
results[].
- Empty SERPs return
404, not an empty array.
- Monitor competitor listings and sponsored placements on Allegro SERPs
- Paginate with
page=2 or listing URLs with &p=2
- Feed repricing engines with live PLN prices and seller metadata
- Discover
listing_url values for Allegro Product enrichment (3 credits per call)
