bricklink.com APIbricklink.com ↗
Search LEGO parts, sets, and minifigures on BrickLink. Get pricing, availability, categories, color guide data, and wanted lists via 6 API endpoints.
curl -X GET 'https://api.parse.bot/scraper/780098fe-28a1-4efb-8c4e-adbcea1a29c4/search_catalog?query=brick+2x4&item_type=P' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for LEGO items in the BrickLink catalog by keyword. Returns up to 25 results per page with pricing and availability information.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'brick 2x4') |
| item_type | string | Item type filter: P (Parts), S (Sets), M (Minifigures), B (Books), G (Gear), C (Catalogs), I (Instructions), O (Original Boxes) |
{
"type": "object",
"fields": {
"items": "array of item objects with item_no, name, item_type, new_qty, new_sellers, new_min_price, used_qty, used_sellers, used_min_price",
"total": "integer total count of matching items"
},
"sample": {
"data": {
"items": [
{
"name": "Brick 2 x 4",
"item_no": "3001",
"new_qty": 6575125,
"used_qty": 2278420,
"item_type": "P",
"new_sellers": 6162,
"used_sellers": 74811,
"new_min_price": "US $0.0055",
"used_min_price": "US $0.0007"
}
],
"total": 1338
},
"status": "success"
}
}About the bricklink.com API
The BrickLink API exposes 6 endpoints covering the full BrickLink LEGO catalog and marketplace, including live pricing and availability. The search_catalog endpoint returns up to 25 items per page with new and used seller counts, minimum prices, and quantity available. Additional endpoints cover item details, category listings, the complete color guide, and authenticated access to user wanted lists.
Catalog Search and Item Details
The search_catalog endpoint accepts a query string and an optional item_type filter (P for Parts, S for Sets, M for Minifigures, B for Books, G for Gear, C for Catalogs, I for Instructions, O for Original Boxes). Each result in the items array includes item_no, name, item_type, and split new/used market data: new_qty, new_sellers, new_min_price, used_qty, used_sellers, and used_min_price. The total field indicates the full result count across pages.
The get_item_details endpoint takes an item_no and optional item_type and returns the item's name, item_no, item_type, internal_id, and a for_sale_preview array with current seller listings and pricing snapshots. This is useful for building item pages or populating price-check tools without running a broad search.
Categories and Color Guide
The list_categories endpoint accepts an item_type parameter and returns an array of category objects with id and name. This lets you build navigation trees or filter UIs that mirror BrickLink's taxonomy. The get_color_guide endpoint requires no inputs and returns the full BrickLink color reference: each color object carries an id, name, and integer counts for parts, in_sets, wanted, and for_sale. This is the canonical BrickLink color inventory across the entire catalog.
Wanted Lists (Authenticated)
The get_wanted_lists endpoint returns all wanted lists for an authenticated user as an array of objects with id and name. The get_wanted_list_items endpoint accepts a list_id (use 0 for the default list) and returns a wantedItems array alongside a wantedListInfo object. Both endpoints require valid session credentials tied to a BrickLink account.
- Build a LEGO part price tracker using
new_min_priceandused_min_pricefromsearch_catalog. - Populate a set inventory tool by querying
get_item_detailsfor each set number and reading thefor_sale_preview. - Generate a color availability dashboard using
parts,in_sets, andfor_salefromget_color_guide. - Create a category browser for LEGO parts or sets using the
idandnamefields fromlist_categories. - Sync a user's BrickLink wanted list into an external shopping or collection management app via
get_wanted_list_items. - Cross-reference new vs. used seller depth on a specific part by comparing
new_sellersandused_sellersfrom search results. - Build a minifigure lookup tool by filtering
search_catalogwithitem_type=Mand surfacing pricing and availability.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BrickLink have an official developer API?+
What does `search_catalog` return for pricing, and does it include historical price data?+
new_min_price, used_min_price, new_qty, used_qty, new_sellers, and used_sellers. Historical price data such as six-month averages or past sale prices is not currently covered. The API covers live catalog and marketplace snapshots. You can fork it on Parse and revise to add endpoints targeting historical price ranges.What is the pagination behavior for `search_catalog`?+
total integer indicating the full match count. There is no built-in page parameter exposed in the current endpoint definition, so results beyond the first 25 are not directly accessible through this endpoint as documented.Does the API return part-out values or set investment data?+
Are store inventory or seller profile details available?+
get_item_details endpoint includes a for_sale_preview array with seller info and pricing for a specific item, but full store inventory browsing and seller profile pages are not currently covered as standalone endpoints. You can fork it on Parse and revise to add seller-specific or store-level endpoints.