ParseForge Scrapers

Rebrickable LEGO Set Scraper

parseforge/rebrickable-lego-scraper

E-commerceDeveloper toolsOther

Scrape LEGO set records from Rebrickable by search term, theme ID, and year range. Returns each set as a flat row with piece count, year, and theme. Export to CSV, JSON, Excel, or XML.

Run this scraper See the API call
Total users
2
Monthly active
1
Total runs
88
Bookmarked
0
Rating
Not rated yet
Last modified
12 days ago

Overview

ParseForge

Rebrickable LEGO Set Scraper

Scrape LEGO set details from Rebrickable by keyword, theme, or year, up to a million sets per run. Every set comes with its piece count, year, theme, and official Rebrickable data. Export to CSV, JSON, Excel, or XML.

Rebrickable's official API is the definitive source for LEGO set data, but writing code to handle pagination, rate limits, and schema mapping takes time you could spend building. This Actor queries the Rebrickable API directly, filters sets by search terms, theme ID, and year range, and returns each match in one flat, consistent row. No custom integration work required.

Who uses it What they scrape Rebrickable for
LEGO resellers Build a live inventory feed with piece counts and release years to price sets accurately.
Data analysts Pull the complete catalog of a theme across decades to track piece-count trends.
App developers Populate a LEGO database with official set metadata without managing API integrations.
Collectors Export a list of every set in a niche theme to track a collection's completion.

What it does

This Actor collects LEGO set records from Rebrickable by keyword search, theme, and year range, and returns each set as a flat row.

  • ๐Ÿ” Keyword search: enter terms like "star wars" or "castle" and get one result set per term.
  • ๐Ÿท๏ธ Theme filter: restrict results to a specific Rebrickable theme ID, such as 158 for Star Wars or 1 for Technic.
  • ๐Ÿ“… Year range: narrow sets to those released within a min and max year window.
  • ๐Ÿ“Š Flexible ordering: sort by newest, oldest, name, most parts, fewest parts, or recently updated.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Rebrickable data

๐Ÿ“ˆ Build a reseller inventory feed.

A LEGO reseller runs the Actor weekly with a theme filter and exports the latest sets to update their online store catalog.

๐Ÿ“Š Analyze LEGO set complexity over time.

A data analyst scrapes all Technic sets from 1980 to today, sorts by piece count, and charts how set sizes have grown.

๐Ÿ—‚๏ธ Populate a personal collection database.

A collector searches for every set in the Castle theme and imports the CSV into their tracking spreadsheet.

๐Ÿ”Ž Find sets by niche keyword.

An enthusiast searches "pirate ship" and "space base" to discover sets they might have missed across all themes.

Why choose this scraper

What you get
Official Rebrickable data Set name, year, piece count, theme, and last-modified date straight from the source.
No code required Configure search terms and filters in a form, then run. The Actor handles the API calls.
Bulk exports Save results as CSV, JSON, Excel, or XML for use in spreadsheets, databases, or apps.
Free API key included A shared Rebrickable key is pre-filled so you can start testing immediately.

How it compares

This Actor focuses on official LEGO sets with keyword search and year filtering, while the Rebrickable LEGO Sets, MOCs & Parts API Actor covers MOCs, parts, and inventories.

Feature ParseForge Rebrickable LEGO Sets, MOCs & Parts API
Keyword search for LEGO sets Yes Not listed
Filter by theme ID Yes Yes
Filter by year range Yes Not listed
MOC and part inventory data Not listed Yes
Pre-filled shared API key Yes Not listed

Configure the run

Drive the Actor from search terms, a theme ID, and a year range, alone or together, and filters run as each set is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "searchTerms": [
    "star wars"
  ],
  "maxItems": 10
}

A larger pull:

{
  "searchTerms": [
    "star wars"
  ],
  "maxItems": 200
}

Pricing

Pay-per-result: $0.011 per result collected. You pay only for the results written to your dataset.

Results collected Approximate cost
100 results $1.10
1,000 results $11.00
10,000 results $110.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

  1. Create a free Apify account with $5 in credit.
  2. Open the Rebrickable LEGO Set Scraper.
  3. Set your inputs and any filters, then click Start.
  4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Rebrickable through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/rebrickable-lego-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that your search terms match actual LEGO set names and that your theme ID and year range are not too restrictive. Try running with only a search term first, then add filters.

Why is the Actor returning only 10 sets?

Free Apify accounts are limited to 10 items as a preview. Upgrade to a paid plan and increase the Maximum sets field to scrape more.

I'm getting an API key error.

The default shared key may be rate-limited during heavy use. Generate your own free Rebrickable API key from your account settings and replace it in the input.

The theme filter is not working.

Ensure you are using a numeric Rebrickable theme ID, not a theme name. You can find theme IDs by browsing themes on the Rebrickable website.

Results are not sorted as expected.

Confirm the Order by dropdown is set to your preferred sort. The default is newest first. Changing it to Most parts or Name will reorder the output.

FAQ

Question Answer
Do I need my own Rebrickable API key? A shared key is provided by default so you can test the Actor. For production use, get your own free key from your Rebrickable account settings to avoid rate-limit contention.
How many LEGO sets can I scrape in one run? Free Apify users are limited to 10 sets per run as a preview. Paid users can scrape up to 1,000,000 sets by adjusting the maximum sets field.
What data does each set row include? Each row returns the official Rebrickable fields: set name, set number, year released, piece count, theme ID, and the last-modified date, among others.
Can I filter by LEGO theme? Yes. Enter a Rebrickable theme ID in the Theme ID field. For example, 158 filters to Star Wars sets and 1 filters to Technic.
Can I search for multiple keywords at once? Yes. Add multiple search terms in the list field and the Actor runs one search per term, returning combined results.
How do I sort the results? Use the Order by dropdown to sort by newest first, oldest first, name, most parts, fewest parts, or recently updated.
Can I limit results to a specific year range? Yes. Set the Min year and Max year fields to restrict results to sets released within that window.
What export formats are supported? You can export your dataset in CSV, JSON, Excel, or XML format from the Apify platform.
Does this Actor scrape Rebrickable MOCs or parts? This Actor focuses on official LEGO sets. For MOCs, parts, and inventories, see the Rebrickable LEGO Sets, MOCs & Parts API Actor on Apify Store.
Is this an official Rebrickable product? No. This Actor is built by a third party and uses the public Rebrickable API. It is not affiliated with or endorsed by Rebrickable.

Related actors

Browse the full ParseForge collection for more scrapers.

๐Ÿ†˜ Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

โš ๏ธ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Rebrickable. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

Input

FieldTypeWhat it doesDefault
searchTerms array Keywords to search LEGO sets (e.g. "star wars", "castle"). One result set per term. Leave empty to list sets by the chosen filters and order. ["star wars"]
themeId integer Optional. Restrict to a Rebrickable theme ID (e.g. 158 = Star Wars, 1 = Technic). not set
minYear integer Optional. Only sets released in or after this year. not set
maxYear integer Optional. Only sets released in or before this year. not set
ordering string (6 options) Sort order for results. -year
maxItems integer Free users: limited to 10 items (preview). Paid users: optional, max 1,000,000. 10
apiKey string Rebrickable API key. A shared key is provided by default. Get your own free key at rebrickable.com account settings. 5c66b3e63d28c87237a0f02fc4a2812e

Pricing

from $9.00 per 1,000 results

Charged forWhat it isPrice each
result Single result in the default dataset. $0.009 to $0.011

Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.

API

One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.

POST ยท run and get results
curl -X POST "https://api.apify.com/v2/acts/parseforge~rebrickable-lego-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "helloWorld": 123
  }'

Examples

Input that runs as-is.

input.json
{
  "helloWorld": 123
}

Reviews

No reviews yet. Be the first.

Issues

We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.

Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.

Related scrapers

Run Rebrickable LEGO Set Scraper on Apify All scrapers