BrickLink LEGO Marketplace Scraper

Extract LEGO catalog data and real-time marketplace pricing from BrickLink — the world's largest LEGO parts and sets marketplace with 1M+ unique items. No login or API key required.

What you can scrape

• Sets, Parts, Minifigures, Books, Gear — all item types across BrickLink's catalog
• Catalog metadata — item name, year released, piece count, minifigure count, category path, thumbnail image
• Price guide (6-month sales history) — times sold, min/avg/max prices for New and Used condition
• Current marketplace inventory — active listings count, min/avg/max asking prices for New and Used

Modes

Mode	Description
search	Keyword search across BrickLink catalog. Returns catalog metadata + optionally marketplace pricing
byItemId	Fetch full price guide for specific item ID(s) (e.g. 75192-1, 3001, sw0001)

Input

Field	Type	Description
mode	string	search or byItemId
searchQuery	string	Keyword to search (mode=search, required in this mode). E.g. millennium falcon, technic crane
itemType	string	Item type filter: S=Sets, P=Parts, M=Minifigures, B=Books, G=Gear, C=Catalogs, I=Instructions, O=Original Boxes, all=All types
itemIds	array	Item IDs to fetch price guides for (mode=byItemId, required in this mode). E.g. ["75192-1", "10179-1"]
itemTypeForIds	string	Item type for byItemId mode: S, P, M, B, G, C, I, O (same 8 types as itemType, minus all — a single-item lookup needs exactly one type)
includePriceGuide	boolean	Fetch 6-month price history for each search result (one extra request per item)
sortBy	string	Sort search results: N=Name, P=Number, Y=Year, D=Date added
maxItems	integer	Maximum records to return (1–1000, default 50)
proxyConfiguration	object	Apify proxy configuration. Defaults to the free AUTO (datacenter) group, which is enabled out of the box — no residential proxy or paid add-on needed. Adds IP diversity as an extra reliability layer; you can disable it in the input if you prefer direct requests.

Output

Each record includes:

{
  "itemId": 162601,
  "itemNumber": "75212-1",
  "itemName": "Kessel Run Millennium Falcon",
  "itemType": "S",
  "itemTypeName": "Set",
  "yearReleased": 2018,
  "pieceCount": 1383,
  "minifigCount": 7,
  "category": "Star Wars > Episode 3",
  "itemUrl": "https://www.bricklink.com/v2/catalog/catalogitem.page?S=75212-1",
  "thumbnailUrl": "https://img.bricklink.com/ItemImage/ST/0/75212-1.t1.png",
  "pg6mNewTimesSold": 55,
  "pg6mNewMinPrice": "US $483.00",
  "pg6mNewAvgPrice": "US $687.14",
  "pg6mNewMaxPrice": "US $1,999.00",
  "pg6mUsedTimesSold": 22,
  "pg6mUsedMinPrice": "US $30.00",
  "pg6mUsedAvgPrice": "US $541.19",
  "pg6mUsedMaxPrice": "US $697.35",
  "pgCurrentNewLots": 245,
  "pgCurrentNewMinPrice": "US $446.56",
  "pgCurrentNewAvgPrice": "US $1,120.13",
  "pgCurrentNewMaxPrice": "US $5,000.00",
  "pgCurrentUsedLots": 64,
  "pgCurrentUsedMinPrice": "US $375.02",
  "pgCurrentUsedAvgPrice": "US $665.10",
  "pgCurrentUsedMaxPrice": "US $1,100.00",
  "scrapedAt": "2026-06-19T11:00:00.000000+00:00"
}

Price guide fields (pg*) are only present when includePriceGuide=true (search mode) or when using byItemId mode.

Usage examples

Search for sets by keyword

{
  "mode": "search",
  "searchQuery": "technic bugatti",
  "itemType": "S",
  "maxItems": 20
}

Get price guide for specific sets

{
  "mode": "byItemId",
  "itemIds": ["75192-1", "10179-1", "42082-1"],
  "itemTypeForIds": "S"
}

Find Batman minifigures with pricing

{
  "mode": "search",
  "searchQuery": "batman",
  "itemType": "M",
  "includePriceGuide": true,
  "maxItems": 50
}

Get part prices

{
  "mode": "byItemId",
  "itemIds": ["3001", "3003", "3004"],
  "itemTypeForIds": "P"
}

FAQ

Do I need a BrickLink account?
No. All catalog data and price guides are publicly accessible without login.

Do I need a proxy?
No, but it's enabled by default at no extra cost. The proxyConfiguration input defaults to Apify's free AUTO (datacenter) proxy group for IP diversity — this does not require a paid plan or residential proxy, and the scraper works the same with it turned off.

Why does a search sometimes take longer than others?
The actor renders each page and waits for it to fully load before reading it, which is a few seconds slower than a plain HTTP request but is what makes results reliable and complete (some BrickLink search result pages — notably "All types" — load their results asynchronously).

How often is price data updated?
Price guide data reflects the last 6 months of completed sales. Current inventory data reflects live listings at scrape time.

What item types are supported?
All 8 BrickLink item types, for both modes: Sets (S), Parts (P), Minifigures (M), Books (B), Gear (G), Catalogs (C), Instructions (I), Original Boxes (O). BrickLink uses the same catalogPG.asp?{type}={id} and catalogitem.page?{type}={id} URL scheme for all 8 types, so byItemId mode (via itemTypeForIds) supports the identical type list as search mode (via itemType).

Can I get prices in a currency other than USD?
No — this is a deliberate limitation, not an oversight. BrickLink's price guide currency is tied to a logged-in account's store/buyer currency preference; the public, unauthenticated catalogPG.asp page does not expose a documented, reliable URL query parameter to request a specific currency (even third-party BrickLink tools report this switch being unreliable). All prices are returned as displayed on the public page, which is USD (e.g. "US $483.00").

How many items can I scrape?
The scraper supports up to 1,000 items per run. BrickLink has 21,000+ sets, 100,000+ parts, and 5,000+ minifigures indexed.

Why are some fields missing in search results?
Some items may not have all metadata available (e.g. year, piece count). Fields are only included when populated — no null values are emitted.

Why does itemUrl show an error when I fetch it with a script instead of opening it in a browser?
itemUrl links to BrickLink's own catalog page for that item, which loads normally when opened in any regular web browser. Plain command-line HTTP requests (e.g. curl) to that specific BrickLink page can get an interstitial response — this is a BrickLink-side behavior on that page, unrelated to this actor. thumbnailUrl (the image CDN) is unaffected and always fetches directly.