BrickLink LEGO Part & Minifig Price Guide Scraper

Scrape BrickLink Price Guide data for LEGO parts, minifigures, and sets. Returns 6-month sold history and current for-sale statistics split by New/Used condition.

BrickLink is the world's largest LEGO aftermarket, with 8M+ listings and $500M+ annual GMV. This actor fetches structured price data from the Price Guide pages (catalogPG.asp) — the same data LEGO investors, parts resellers, MOC designers, and eBay arbitrageurs use daily.

What you can do with this actor

• LEGO investing: Build arbitrage models comparing sealed set prices vs parted-out value
• Parts reselling: Monitor price trends for high-demand bricks across all colors
• Store management: Track current for-sale competition and price your lots competitively
• Market research: Analyze price history for any part, minifig, or set in any color

Input

Field	Type	Description
partIds	array	BrickLink part IDs (e.g. ["3001", "3002"]). Each part in multiple colors returns one record per color unless colorIds is specified.
minifigIds	array	BrickLink minifig IDs (e.g. ["sw0001", "col001"])
setIds	array	BrickLink set numbers (e.g. ["10300-1", "75192-1"])
colorIds	array	Restrict part lookups to specific color IDs. Empty = all available colors.
condition	string	both (default), new, or used
currency	string	Currency code for prices (default: USD)
maxItems	integer	Cap on records returned (0 = unlimited)

At least one of partIds, minifigIds, or setIds is required.

Output

Each record in the dataset represents one item + color combination:

{
  "bl_item_id": "3001",
  "item_type": "PART",
  "item_name": "Brick 2 x 4",
  "category": "Brick",
  "color": "Black",
  "color_id": 11,
  "pg_new_times_sold": 42,
  "pg_new_total_qty": 1850,
  "pg_new_min_price": 0.02,
  "pg_new_max_price": 0.25,
  "pg_new_avg_price": 0.08,
  "pg_new_qty_avg_price": 0.06,
  "pg_used_times_sold": 38,
  "pg_used_total_qty": 2100,
  "pg_used_min_price": 0.01,
  "pg_used_max_price": 0.15,
  "pg_used_avg_price": 0.05,
  "pg_used_qty_avg_price": 0.04,
  "fs_new_lots": 120,
  "fs_new_total_qty": 45000,
  "fs_new_min_price": 0.02,
  "fs_new_max_price": 0.30,
  "fs_new_avg_price": 0.08,
  "fs_used_lots": 95,
  "fs_used_total_qty": 28000,
  "fs_used_min_price": 0.01,
  "fs_used_max_price": 0.20,
  "fs_used_avg_price": 0.05,
  "currency": "USD",
  "price_guide_url": "https://www.bricklink.com/catalogPG.asp?P=3001&colorID=11",
  "image_url": "https://img.bricklink.com/P/11/3001.jpg",
  "scrapedAt": "2026-05-25T06:17:00.000Z"
}

Field groups

6-month sold history (pg_*): Based on actual completed sales in the past 6 months from BrickLink's marketplace.

Currently for sale (fs_*): Live inventory and asking prices across all BrickLink stores at time of scrape.

Finding BrickLink IDs

• Parts: Visit any part page on BrickLink — the ID is in the URL: bricklink.com/v2/catalog/catalogitem.page?P=3001 — ID is 3001
• Minifigs: bricklink.com/v2/catalog/catalogitem.page?M=sw0001 — ID is sw0001
• Sets: bricklink.com/v2/catalog/catalogitem.page?S=10300-1 — ID is 10300-1
• Color IDs: See the BrickLink color chart — color 11 = Black, 1 = White, 5 = Red, etc.

Notes

• BrickLink prices are community-sourced from actual marketplace transactions
• Price Guide data refreshes weekly on BrickLink's end
• Parts with many color variants will produce one record per color when no colorIds filter is applied — a common part like 3001 exists in 60+ colors
• Reliable access to BrickLink price guide pages on every run