Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Allegro

1 credit per call4 endpoints12 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 keyRun 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 OKJSONX-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.

#idstringauthorstringratingintegertextstringprosstringconsstringcreated_atstringhelpful_countintegernot_helpful_countintegerlanguagestringis_bestbooleanseller_loginstring
1624d54214c83d2711b4d6d53K...05Mimo 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ńczenieCena, brak możliwości ustawiania dowolnie ikon, konieczność aktywacji Apple Pay aby użyć NFC2022-04-06T08:49:37Z64pl-PLtrueAllegro
26182e1686fb818521dbeed8ap...g51. 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:16Z165pl-PLfalselantre_pl
3617415e1d146a23ff50cbb34H...g5Ś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 aparatCena, brak słuchawek w zestawie2021-10-23T14:02:09Z135pl-PLfalseAllegro

Recorded from our API · 3 items shown · 12 datapoints per itemGET /v1/allegro/reviews?product_id=86530fbb-7c5a-41cc-92e2-6d622aa75509

12 datapoints

Identity

  • idstring

Contact

  • seller_loginstring

Reputation

  • ratinginteger

Other

  • authorstring
  • textstring
  • prosstring
  • consstring
  • created_atstring
  • helpful_countinteger
  • not_helpful_countinteger
  • languagestring
  • is_bestboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/allegro/categories
none+2 optional
1–20 credits
GET/v1/allegro/offer
none+3 optional
20 credits
GET/v1/allegro/reviews
product_id+2 optional
1 credit
GET/v1/allegro/search
query+11 optional
20 credits

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBADepop

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 keyRead the docs