cults3d.com APIcults3d.com ↗
Access 3D printable models, creator profiles, categories, and engagement data from Cults3D via a structured JSON API. Search, filter, and browse listings.
curl -X GET 'https://api.parse.bot/scraper/169fdf69-3188-4e01-aaa1-3911b5753c25/search_creations?limit=2&query=vase&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for 3D models by keyword with optional pagination. Returns matching creations sorted by relevance.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| queryrequired | string | Search keyword (e.g. 'dragon', 'vase', 'miniature'). |
| offset | integer | Number of results to skip for pagination. |
{
"type": "object",
"fields": {
"total": "integer total number of matching creations",
"results": "array of creation objects with name, slug, url, description, price, publishedAt, illustrationImageUrl, creator, category, likesCount, viewsCount, downloadsCount"
},
"sample": {
"data": {
"total": 68094,
"results": [
{
"url": "https://cults3d.com/en/3d-model/game/dragon-theminitednews-3",
"name": "Dragon",
"slug": "dragon-theminitednews-3",
"price": {
"value": 0,
"currency": "EUR",
"formatted": "€ 0"
},
"creator": {
"nick": "WowManRandoManEatPeople"
},
"category": {
"name": "Game",
"slug": "game"
},
"likesCount": 66,
"viewsCount": 17783,
"description": "#TABLETOPXLYCHEE",
"publishedAt": "2025-01-10T00:48:00Z",
"downloadsCount": 2295,
"illustrationImageUrl": "https://images.cults3d.com/..."
}
]
},
"status": "success"
}
}About the cults3d.com API
The Cults3D API provides access to the Cults3D marketplace through 5 endpoints covering model search, detailed creation metadata, creator profiles, category listings, and batch browsing. The search_creations endpoint accepts keyword queries and returns creation objects with pricing, publication date, like counts, and category data. Whether you need to index free models, track designer output, or filter editor's picks by category, the endpoints expose the fields required to do it.
What the API Covers
The API exposes five endpoints against the Cults3D 3D model marketplace. search_creations accepts a query string plus optional limit and offset parameters and returns a total count alongside an array of creation objects — each including name, slug, url, description, price, publishedAt, illustrationImageUrl, creator, category, and likesCount. This is the right starting point for keyword-driven discovery. The slug values in those results feed directly into get_creation_detail.
Creation Detail and Creator Profiles
get_creation_detail takes a slug and returns the full record for a single model: tags, license (with name and code), makes (community prints, each with its own creator and image), price broken into formatted, value, and currency fields, and a details string for printing notes. get_creator_profile takes a creator's nick and returns their bio, followersCount, followeesCount, creationsCount, and an array of their 10 most recent creations with name, slug, price, and thumbnail.
Batch Browsing and Categories
get_creations_batch is the primary listing endpoint. It supports sort (BY_PUBLICATION or BY_POPULARITY), only_free, only_priced, selected (editor's picks), category_slug, limit, and offset. Results include viewsCount and likesCount alongside the standard creation fields. get_categories takes no inputs and returns the full list of top-level category objects — each with a name and slug — suitable for populating a filter UI or iterating over the taxonomy systematically.
- Build a 3D model search engine filtered by category slug and sorted by popularity using
get_creations_batch - Track designer activity by polling
get_creator_profilefor follower count and recent creation arrays - Aggregate free model listings across categories using the
only_freefilter inget_creations_batch - Collect license metadata from
get_creation_detailto flag models safe for commercial remixing - Index editor's picks by setting
selected: trueinget_creations_batchfor curated model feeds - Display community makes (real-world prints) for a model using the
makesarray fromget_creation_detail - Map the full Cults3D category tree by calling
get_categoriesand iterating slugs into downstream queries
| 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 Cults3D have an official developer API?+
What does `get_creation_detail` return beyond what `search_creations` provides?+
get_creation_detail adds fields not present in search results: tags (array of strings), license (with name and code), a details string for printing notes, and a makes array listing community prints of that model — each with its own creator nick, description, and image URL.Can I retrieve all creations by a specific creator, not just the 10 most recent?+
get_creator_profile returns up to 10 recent creations and a creationsCount integer showing the total. Full paginated access to a creator's complete catalog is not currently covered. You can fork this API on Parse and revise it to add a creator-scoped listing endpoint.Does the API expose download counts for models?+
likesCount and viewsCount as engagement signals, but download counts are not currently exposed. You can fork this API on Parse and revise it to add that field if it becomes available in the source data.How does pagination work across endpoints?+
search_creations and get_creations_batch both accept offset and limit integer parameters, and each response includes a total field so you can calculate the number of pages. get_creator_profile does not support pagination — it always returns the 10 most recent creations for that creator.