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.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 88
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
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
- Create a free Apify account with $5 in credit.
- Open the Rebrickable LEGO Set Scraper.
- Set your inputs and any filters, then click Start.
- 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
| Field | Type | What it does | Default |
|---|---|---|---|
| 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 for | What it is | Price 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.
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.
{
"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.
