Allegro API
The Allegro API returns listings from Poland's largest online marketplace as clean JSON.
5 actionsLive JSON1,000 free creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns offers with id, title, URL, price, delivery text and seller details (login, super-seller flag, positive-feedback percent), and you can browse a category, pull an offer, a seller's offers and suggestions. It is built for price intelligence, marketplace tools and Polish e-commerce analytics that need Allegro data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/allegro/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone 15"
}
}Captured response
{
"ok": true,
"meta": {
"api": "allegro",
"endpoint": "search",
"mode": "live",
"latency_ms": 4441.4,
"record_count": 68,
"bytes": 0,
"cache_hit": false,
"method": "camoufox_mint_curl_replay",
"total": 191138,
"source": "listing",
"partial": false
},
"data": {
"query": "iphone 15",
"offers": [
{
"id": "[redacted-phone]",
"product_id": "2c471a7b-e083-42cc-b811-faffef64ef77",
"title": "Smartfon Apple iPhone 15 6 GB / 128 GB 5G czarny",
"url": "https://allegro.pl/produkt/smartfon-apple-iphone-15-6-gb-128-gb-5g-czarny-2c471a7b-e083-42cc-b811-faffef64ef77?offerId=[redacted-phone]",
"type": "product",
"context": "PROMOTED",
"is_sponsored": false,
"promoted": true,
"price": {
"amount": 2729,
"currency": "PLN"
},
"price_with_delivery": {
"amount": 2739.49,
"currency": "PLN"
},
"delivery_text": "2739,49 zł z dostawą",
"lowest_shipping": {
"amount": 10.49,
"currency": "PLN"
},
"free_delivery": false,
"free_return": false,
"rating": 4.91,
"rating_count": 799,
"product_offers_count": 150,
"popularity": "326 osób kupiło ostatnio",
"image_url": "https://a.allegroimg.com/s180/293353/9b60faf240b3a165d8c36199f7d5/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-czarny",
"images": [
"https://a.allegroimg.com/s360/293353/9b60faf240b3a165d8c36199f7d5/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-czarny",
"https://a.allegroimg.com/s360/290625/c6fb3be748c3b3312d457c8a946d/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-czarny-Ladowarka-w-komplecie-nie",
"https://a.allegroimg.com/s360/1119a2/8afbdd2f4d01b7dc3a812b72811a/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-czarny-Sluchawki-w-komplecie-nie"
],
"parameters": [
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"seller": {
"id": "[redacted-phone]",
"login": "SimplyBuy",
"super_seller": false,
"company": true,
"positive_feedback_percent": 98.7,
"listing_url": "https://allegro.pl/uzytkownik/SimplyBuy",
"type": "Firma"
},
"category_id": "322851"
},
{
"id": "[redacted-phone]",
"product_id": "dda6f97d-704e-45ca-bd3b-60dfc1684e0b",
"title": "Smartfon Apple iPhone 15 6 GB / 128 GB 5G zielony",
"url": "https://allegro.pl/produkt/smartfon-apple-iphone-15-6-gb-128-gb-5g-zielony-dda6f97d-704e-45ca-bd3b-60dfc1684e0b?offerId=[redacted-phone]",
"type": "product",
"context": "REGULAR",
"is_sponsored": false,
"promoted": false,
"price": {
"amount": 1348,
"currency": "PLN"
},
"price_with_delivery": {
"amount": 1358.49,
"currency": "PLN"
},
"delivery_text": "1358,49 zł z dostawą",
"lowest_shipping": {
"amount": 10.49,
"currency": "PLN"
},
"free_delivery": false,
"free_return": false,
"rating": 4.7,
"rating_count": 101,
"product_offers_count": 31,
"popularity": "34 osoby kupiły ostatnio",
"image_url": "https://a.allegroimg.com/s180/11e631/a77762664d19a2acd8c6110595d7/TELEFON-APPLE-IPHONE-15-128GB-91-BAT-OPIS",
"images": [
"https://a.allegroimg.com/s360/11e631/a77762664d19a2acd8c6110595d7/TELEFON-APPLE-IPHONE-15-128GB-91-BAT-OPIS",
"https://a.allegroimg.com/s360/11eea0/e4e8f4304bf8a1dbebf63557fe0d/TELEFON-APPLE-IPHONE-15-128GB-91-BAT-OPIS-Marka-Apple",
"https://a.allegroimg.com/s360/1138be/abe9b19745d8b9693f27c03fb60d/TELEFON-APPLE-IPHONE-15-128GB-91-BAT-OPIS-Wbudowana-pamiec-128-GB"
],
"parameters": [
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"seller": {
"id": "[redacted-phone]",
"login": "alleloombard1077",
"super_seller": false,
"company": true,
"positive_feedback_percent": 97.2,
"listing_url": "https://allegro.pl/uzytkownik/alleloombard1077",
"type": "Firma"
},
"category_id": "322851"
},
{
"id": "[redacted-phone]",
"product_id": "349b3b2d-921f-4468-92fd-f26f4b9bed32",
"title": "Smartfon Apple iPhone 15 6 GB / 128 GB 5G niebieski",
"url": "https://allegro.pl/produkt/smartfon-apple-iphone-15-6-gb-128-gb-5g-niebieski-349b3b2d-921f-4468-92fd-f26f4b9bed32?offerId=[redacted-phone]",
"type": "product",
"context": "REGULAR",
"is_sponsored": false,
"promoted": false,
"price": {
"amount": 2649,
"currency": "PLN"
},
"price_with_delivery": {
"amount": 2659.49,
"currency": "PLN"
},
"delivery_text": "2659,49 zł z dostawą",
"lowest_shipping": {
"amount": 10.49,
"currency": "PLN"
},
"free_delivery": false,
"free_return": false,
"rating": 4.93,
"rating_count": 307,
"product_offers_count": 88,
"popularity": "334 osoby kupiły ostatnio",
"image_url": "https://a.allegroimg.com/s180/2985c6/e625527c445690b37789cb822216/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-niebieski",
"images": [
"https://a.allegroimg.com/s360/2985c6/e625527c445690b37789cb822216/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-niebieski",
"https://a.allegroimg.com/s360/291fb1/e5c435d04ac39262b811fbce431f/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-niebieski-Ladowarka-w-komplecie-nie",
"https://a.allegroimg.com/s360/298b60/d27b95ca413da86797b2a7b52fd5/Smartfon-Apple-iPhone-15-6-GB-128-GB-5G-niebieski-Sluchawki-w-komplecie-nie"
],
"parameters": [
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"seller": {
"id": "[redacted-phone]",
"login": "SimplyBuy",
"super_seller": false,
"company": true,
"positive_feedback_percent": 98.7,
"listing_url": "https://allegro.pl/uzytkownik/SimplyBuy",
"type": "Firma"
},
"category_id": "322851"
}
],
"count": 68,
"total": 191138,
"last_page": 100,
"pages_fetched": 1,
"partial": false,
"category_path": [
{
"id": "954b95b6-43cf-[redacted-phone]-dea4d9b10ddf",
"name": "Allegro",
"alias": "/"
},
{
"id": "42540aec-367a-4e5e-b411-17c09b08e41f",
"name": "Elektronika",
"alias": "elektronika"
},
{
"id": "4",
"name": "[redacted-name]",
"alias": "telefony-i-akcesoria"
}
]
}
}Actions
What the Allegro API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Allegro by keyword — returns offer cards with title, price (PLN), delivery cost, seller, rating, photos and offer URL. Supports price range, condition, free-delivery, sort and category filters, with page pagination. | Pricing teams call search to search Allegro by keyword. | query, max_pages, sort, min_price, max_price, ... |
| category | Browse an Allegro category without a keyword (the /kategoria/<slug> grid) — discover popular offers in a category. Supports price/condition/free-delivery/sort filters and page pagination. | Marketplace operators call category to get browse an Allegro category without a keyword (the /kategoria/<slug> grid). | category, max_pages, sort, min_price, max_price, ... |
| offer | Single Allegro offer/product detail by id or URL — title, price (PLN), main image and gallery, seller handle, and description. | Catalog enrichment teams call offer to get single Allegro offer/product detail by id or URL. | offer_id, offer_url, url |
| seller_offers | A seller's public active listings, paginated — every offer a seller (shop) has live. Provide the seller login (handle from a seller URL / a search result's seller.login). | Retail analysts call seller_offers to get a seller's public active listings, paginated. | seller, max_pages, sort |
| suggested | Related/recommended Allegro offers for a keyword — a quick set of relevant offers (the first result page) useful for 'more like this' / market discovery. | Pricing teams call suggested to get related/recommended Allegro offers for a keyword. | query |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/allegro/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15"}'import requests
r = requests.post(
"https://api.reefapi.com/allegro/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 15"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/allegro/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone 15"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.allegro.search with {"query":"iphone 15"}.Use cases
Who uses this API and why
- Pricing teams call search to track competitor prices and delivery offers across Allegro.
- Seller-intelligence tools use seller_offers to audit a competitor's full Allegro inventory.
- Market analysts use category to size supply and price ranges in a Polish product segment.
FAQ
Questions developers ask before integrating
What is the Allegro API?
Allegro API is a ReefAPI endpoint group for allegro It returns live JSON through POST requests under /allegro/v1.
Is the Allegro API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Allegro calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Allegro login or account?
No login to Allegro is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Allegro data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Allegro API use?
Allegro actions currently cost 2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Allegro from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call allegro actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Allegro API a Allegro scraper?
It is the managed alternative to a DIY Allegro scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same allegro back as clean JSON.
Why does my Allegro scraper keep getting blocked?
Most Allegro scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.