--- title: "Allegro API: JSON data, 4 endpoints, 1 credit per call" description: "Allegro API for offer search, offer details, product reviews and categories in Poland, Czechia and Slovakia as JSON, from 1 credit per call." url: https://perceptlayer.com/apis/allegro --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Allegro 1 credit per call 4 endpoints 12 datapoints # Allegro API Allegro API for offer search, offer details, product reviews and categories in Poland, Czechia and Slovakia as JSON, from 1 credit per call. [Get a free API key](https://perceptlayer.com/signup) Run it below Allegro GET /v1/allegro/reviews?product\_id=86530fbb-7c5a-41cc-92e2-6d622aa75509 ``` { "success": true, "data": { "product_id": "86530fbb-7c5a-41cc-92e2-6d622aa75509", "reviews": [ { "id": "624d54214c83d2711b4d6d53", "author": "K...0", "rating": 5, "text": "Mimo początkowych wątpliwości po przesiadce z Androida, jestem całkiem zadowolona. 13stka działa szybko i prezentuje się bardzo dobrze. Aparat to zdecydowany plus tego modelu. Po androidzie najbardziej boli brak możliwości dostosowania sobi…", "pros": "Aparat, bateria, faceID, dobry dźwięk, świetny wyświetlacz, szybkość działania, wykończenie", "cons": "Cena, brak możliwości ustawiania dowolnie ikon, konieczność aktywacji Apple Pay aby użyć NFC", "created_at": "2022-04-06T08:49:37Z", "helpful_count": 6, "not_helpful_count": 4, "language": "pl-PL", "is_best": true, "seller_login": "Allegro" }, { "id": "6182e1686fb818521dbeed8a", "author": "p...g", "rating": 5, "text": "1. bateria trzyma dłużej niż 12 \n2. aparat ma jakieś nowe funkcje wcześniej też był super\n3. Kolor ekstra\n4. Wykonanie ekstra\n5. Pamięci dwa razy więcej niż w 12 mówie o podstawowej funkcji", "created_at": "2021-11-03T19:22:16Z", "helpful_count": 16, "not_helpful_count": 5, "language": "pl-PL", "is_best": false, "seller_login": "lantre_pl" }, { "id": "617415e1d146a23ff50cbb34", "author": "H...g", "rating": 5, "text": "Świetny telefon w zasadzie pod każdym względem. Jeżeli przesiadasz się z 11tki lub wcześniejszych mega zmiana na plus. W porównaniu do 12ki zmiany bardziej kosmetyczne.", "pros": "Wyświetlacz, dobry aparat", "cons": "Cena, brak słuchawek w zestawie", "created_at": "2021-10-23T14:02:09Z", "helpful_count": 13, "not_helpful_count": 5, "language": "pl-PL", "is_best": false, "seller_login": "Allegro" } ], "pagination": { "current_page": 1, "total_results": 69, "total_pages": 4, "has_next": true }, "features": [ { "label": "Jakość wykonania", "sentiment": "positive", "mentions": 12, "positive_mentions": 11, "negative_mentions": 1 }, { "label": "Wydajność", "sentiment": "positive", "mentions": 10, "positive_mentions": 8, "negative_mentions": 2 }, { "label": "Aparat fotograficzny", "sentiment": "positive", "mentions": 9, "positive_mentions": 7, "negative_mentions": 2 } ] }, "meta": { "endpoint_family": "reviews", "request_id": "req_fd6cdfd8957446b8943fdb57d807e16c", "credits_charged": 1, "credits_remaining": 1993 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `reviews`: the fields and shapes you will get, shortened to 3 items. | # | id string | author string | rating integer | text string | pros string | cons string | created\_at string | helpful\_count integer | not\_helpful\_count integer | language string | is\_best boolean | seller\_login string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 624d54214c83d2711b4d6d53 | K...0 | 5 | Mimo początkowych wątpliwości po przesiadce z Androida, jestem całkiem zadowolona. 13stka działa szybko i prezentuje się bardzo dobrze. Aparat to zdecydowany plus tego modelu. Po androidzie najbardziej boli brak możliwości dostosowania sobi… | Aparat, bateria, faceID, dobry dźwięk, świetny wyświetlacz, szybkość działania, wykończenie | Cena, brak możliwości ustawiania dowolnie ikon, konieczność aktywacji Apple Pay aby użyć NFC | 2022-04-06T08:49:37Z | 6 | 4 | pl-PL | true | Allegro | | 2 | 6182e1686fb818521dbeed8a | p...g | 5 | 1\. bateria trzyma dłużej niż 12 2. aparat ma jakieś nowe funkcje wcześniej też był super 3. Kolor ekstra 4. Wykonanie ekstra 5. Pamięci dwa razy więcej niż w 12 mówie o podstawowej funkcji | — | — | 2021-11-03T19:22:16Z | 16 | 5 | pl-PL | false | lantre\_pl | | 3 | 617415e1d146a23ff50cbb34 | H...g | 5 | Świetny telefon w zasadzie pod każdym względem. Jeżeli przesiadasz się z 11tki lub wcześniejszych mega zmiana na plus. W porównaniu do 12ki zmiany bardziej kosmetyczne. | Wyświetlacz, dobry aparat | Cena, brak słuchawek w zestawie | 2021-10-23T14:02:09Z | 13 | 5 | pl-PL | false | Allegro | Recorded from our API · 3 items shown · 12 datapoints per item GET /v1/allegro/reviews?product\_id=86530fbb-7c5a-41cc-92e2-6d622aa75509 12 datapoints ### Identity - id string ### Contact - seller\_login string ### Reputation - rating integer ### Other - author string - text string - pros string - cons string - created\_at string - helpful\_count integer - not\_helpful\_count integer - language string - is\_best boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/allegro/reviews?product_id=86530fbb-7c5a-41cc-92e2-6d622aa75509" \ -H "X-API-Key: $API_KEY" ``` Allegro · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/allegro/categories`](https://perceptlayer.com/apis/allegro/categories) | none +2 optional | 1–20 credits | | [GET `/v1/allegro/offer`](https://perceptlayer.com/apis/allegro/offer) | none +3 optional | 20 credits | | [GET `/v1/allegro/reviews`](https://perceptlayer.com/apis/allegro/reviews) | `product_id` +2 optional | 1 credit | | [GET `/v1/allegro/search`](https://perceptlayer.com/apis/allegro/search) | `query` +11 optional | 20 credits | Overview ## About the Allegro API ## What you can get The Allegro API returns Allegro marketplace data as JSON through 4 endpoints. `search`, `offer` and `categories` take a `country` (PL, CZ or SK). - **Search:** `search` takes a `query`, with `category`, `price_from`, `price_to`, `condition` (new, used, damaged or refurbished), `buy_now`, `smart`, `super_seller`, `seller_id`, `page` and `sort` (relevance, price\_asc, price\_desc, price\_with\_delivery\_asc, price\_with\_delivery\_desc, popularity, newest or time\_left). - **Offers:** `offer` takes an `offer_id` or an offer `url`. - **Reviews:** `reviews` takes a `product_id`, with `page` and `rating`. - **Categories:** `categories` returns the top-level list, or the tree under one `category`. The recorded reviews call for one product returns `reviews`, each with `id`, `author`, `rating`, `text`, `pros`, `cons`, `created_at`, `helpful_count`, `not_helpful_count`, `language`, `is_best` and `seller_login`. It also returns `pagination` with `total_results` (69 in that recording), `total_pages` and `has_next`, and `features`, each with a `label`, `sentiment`, `mentions`, `positive_mentions` and `negative_mentions`. ## How a call works Read a product's reviews: `GET /v1/allegro/reviews?product_id=86530fbb-7c5a-41cc-92e2-6d622aa75509` with your key in the `X-API-Key` header, then pass the next `page` while `has_next` is true. Look up a single offer with `GET /v1/allegro/offer?offer_id=16571803677`, and use `categories` to find a `category` to narrow a `search`. `search` and `offer` cost 20 credits, `reviews` costs 1, and `categories` costs 1 for the top-level list or 20 for one category's tree. Failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) Use cases ### Track Allegro prices for a product, with or without delivery `Use the Allegro API to track Allegro prices for a product, with or without delivery` ### Compare new, used and refurbished offers `Use the Allegro API to compare new, used and refurbished offers` ### Watch auctions ending soon with \`time\_left\` `` Use the Allegro API to watch auctions ending soon with `time_left` `` ### Find which product features buyers praise or criticise, from review \`features\` `` Use the Allegro API to find which product features buyers praise or criticise, from review `features` `` FAQ ## Questions **How much does the Allegro API cost?** \`search\` and \`offer\` cost 20 credits per successful call, and \`reviews\` costs 1. \`categories\` costs 1 for the top-level list and 20 when you ask for the tree under one category. Failed calls cost nothing. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I sort by price including delivery?** Yes. Pass \`sort=price\_with\_delivery\_asc\` or \`sort=price\_with\_delivery\_desc\` to \`search\`. **Do I need an Allegro account?** No. You call this Allegro API with your Perceptlayer key in the \`X-API-Key\` header, with no Allegro login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build an Allegro scraper instead?** You can, but an Allegro scraper is code you maintain: page changes break it, requests get blocked, and Allegro's terms govern how you collect data. The Allegro API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Allegro API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)