Allegro Search
Allegro Search API. Query product listings by keyword, optional page number, or full allegro.pl listing URL. Returns results with prices, sellers, sponsorship flags and pagination. 3 credits per call.
Credit cost: 3 credits per call
Autorisierung
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Abfrageparameter
query*string
Search keyword or full Allegro listing URL.
Examples (keyword):
mufowaKarty pokemonExamples (listing URL):
https://allegro.pl/listing?string=mufowahttps://allegro.pl/listing?string=mufowa&p=2Notes:
- Pass a keyword alone for page 1, or paste a full
allegro.pl/listingURL. - Use
pageto paginate on keywords (page=2→&p=2). Overridesp=in listing URLs. stringis the search term;pis the page number in the URL.- Polish diacritics are supported. Results may include sponsored listings.
page?number
Page number for keyword searches (default 1).
Example:
2Overrides p= when query is a full listing URL.
Antworttext
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/allegro/search?query=string"{ "results": [ { "price": 17.84, "title": "ZŁĄCZKA MUFOWA ZAPRASOWYWANA PEX ALUPEX 32 x 1'' GW TYP SZCZĘK \"U\" MOSIĄDZ", "currency": "PLN", "offer_id": "13183761915", "position": 0, "image_url": "https://a.allegroimg.com/s360/116ee2/44bad5d14926a20193c6cb2d8c29/ZLACZKA-MUFOWA-ZAPRASOWYWANA-PEX-ALUPEX-32-x-1-GW-TYP-SZCZEK-U-MOSIADZ", "seller_id": "36900410", "product_id": "8d15c247-8aeb-4b82-b078-dfae9aa50931", "listing_url": "https://allegro.pl/oferta/zlaczka-mufowa-zaprasowywana-pex-alupex-32-x-1-gw-typ-szczek-u-mosiadz-13183761915?bi_s=ads&bi_m=productlisting%3Adesktop%3Aquery&bi_c=ZWUxZGI3YTktZjhmYS00M2U1LWFmZjktMWE2YWM2N2NmZGJjAA&bi_t=ape", "seller_name": "HYDMAR", "is_sponsored": true, "delivery_info": "28,33 zł z dostawą" }, { "price": 3.8, "title": "Mufa ocynkowana TICKA złączka mufowa fi 125 do rur spiro wentylacja", "currency": "PLN", "offer_id": "16509668391", "position": 1, "image_url": "https://a.allegroimg.com/s360/112b7f/92e216854e069e9f43f2adbc4c74/Mufa-ocynkowana-TICKA-zlaczka-mufowa-fi-125-do-rur-spiro-wentylacja", "seller_id": "48847819", "product_id": "6357bbc1-df4f-48ec-8e99-b346a1326f3c", "listing_url": "https://allegro.pl/produkt/mufa-ocynkowana-ticka-zlaczka-mufowa-fi-125-do-rur-spiro-wentylacja-6357bbc1-df4f-48ec-8e99-b346a1326f3c?offerId=16509668391", "seller_name": "amster24_pl", "is_sponsored": false, "delivery_info": "14,29 zł z dostawą" }, { "price": 16.03, "title": "ZŁĄCZKA MUFOWA ZAPRASOWYWANA PEX ALUPEX FI 25 mm x 1'' GW TYP SZCZĘK \"U\" MO", "currency": "PLN", "offer_id": "13183762597", "position": 2, "image_url": "https://a.allegroimg.com/s360/114c67/910f7eea4200aec18626dc2d5914/ZLACZKA-MUFOWA-ZAPRASOWYWANA-PEX-ALUPEX-FI-25-mm-x-1-GW-TYP-SZCZEK-U-MO", "seller_id": "36900410", "product_id": "261dee24-a4cc-4e11-bbb4-037bb429ad8d", "listing_url": "https://allegro.pl/oferta/zlaczka-mufowa-zaprasowywana-pex-alupex-fi-25-mm-x-1-gw-typ-szczek-u-mo-13183762597?bi_s=ads&bi_m=productlisting%3Adesktop%3Aquery&bi_c=ZWUxZGI3YTktZjhmYS00M2U1LWFmZjktMWE2YWM2N2NmZGJjAA&bi_t=ape", "seller_name": "HYDMAR", "is_sponsored": true, "delivery_info": "25,02 zł z dostawą" } ], "pagination": { "next": "https://allegro.pl/listing?string=mufowa&p=2", "page": 1, "per_page": 74, "total_pages": 13, "total_results": 1628 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}