Piloterr

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

GET
/v2/allegro/search

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 or full Allegro listing URL.

Examples (keyword):

mufowa
Karty pokemon

Examples (listing URL):

https://allegro.pl/listing?string=mufowa
https://allegro.pl/listing?string=mufowa&p=2

Notes:

  • Pass a keyword alone for page 1, or paste a full allegro.pl/listing URL.
  • Use page to paginate on keywords (page=2 → &p=2). Overrides p= in listing URLs.
  • string is the search term; p is 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:

2

Overrides p= when query is a full listing URL.

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"

{
  "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"
}