pinshape.com APIpinshape.com ↗
Access Pinshape 3D printable model metadata, user profiles, collections, community prints, and comments via 9 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/98dc5891-041d-4bb8-91fe-a165dff9b8fa/search_models?limit=5&query=elephant' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for 3D printable models by keyword and filters. Returns paginated results with item cards including creator info, pricing, and engagement counts.
| Param | Type | Description |
|---|---|---|
| nsfw | integer | NSFW filter. Accepted values: 0, 1. |
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: most-popular, newest-first, oldest-first, price-low-high, price-high-low. |
| limit | integer | Number of items per page. |
| query | string | Search query string. |
| pricing | string | Pricing filter. Accepted values: all, free, paid. |
| category | string | Category name. Accepted values: Art, Jewelry + Fashion, Gadgets, Home Living, Miniatures, Toys + Games, People + Creatures, Other. |
{
"type": "object",
"fields": {
"items": "array of model card objects, each with id, slug, title, description_snippet, thumbnail, price, likes_count, download_count, creator, and url",
"pagination": "object with current_page, total_pages, total_items, and has_next"
},
"sample": {
"data": {
"items": [
{
"id": "662",
"url": "https://pinshape.com/items/662-elephant",
"slug": "elephant",
"price": "Free",
"title": "Elephant",
"creator": {
"id": "1194",
"slug": "le-fabshop",
"username": "le FabShop"
},
"thumbnail": "https://mh-pinshape-public.s3.us-west-1.amazonaws.com/uploads/image/file/2632/container_elephant-3d-printing-2632.jpg",
"likes_count": 2475,
"download_count": 35183,
"description_snippet": "We created this cute little articulated elephant last month for our friends i..."
}
],
"pagination": {
"has_next": true,
"total_items": 107,
"total_pages": 22,
"current_page": 1
}
},
"status": "success"
}
}About the pinshape.com API
The Pinshape API provides access to Pinshape.com's catalog of 3D printable models across 9 endpoints, returning structured data on model metadata, community prints, user profiles, and curated collections. The search_models endpoint supports keyword queries with filters for category, pricing, and sort order, while get_model_details returns full model data including tags, file listings, license type, and creator info. Every response uses consistent numeric IDs and slugs that chain naturally across endpoints.
Model Search and Detail
The search_models endpoint accepts a query string alongside filters for category (e.g. Miniatures, Jewelry + Fashion), pricing (free, paid, or all), sort (most-popular, newest-first, price-low-high, and others), and an nsfw flag. Results come back as paginated item cards with fields including id, slug, title, description_snippet, thumbnail, price, likes_count, download_count, and a nested creator object. The pagination object exposes current_page, total_pages, total_items, and has_next for cursor-free traversal.
get_model_details takes the item_id and slug from search results and returns the full record: description, tags array, files array with filename and size, license string, and likes_count. get_model_comments and get_model_prints both accept item_id and an optional page parameter. Comments include content, username, created_at, likes_count, and threading metadata. Community prints include images, print_settings, rating, and created_at; models with no community makes return an empty prints array.
User Profiles and Collections
get_user_profile accepts a numeric user_id and username slug, returning display_name, followers, following, likes, location, twitter, and website. Optional fields like twitter, website, and location may be absent if the user has not set them. get_user_models and get_user_likes both return paginated item card arrays with the same shape as search_models results, making it straightforward to aggregate a user's full public activity. get_user_likes returns an empty items array for users whose likes are not public.
get_user_collections returns paginated collection objects with id, title, and url. Passing a collection id to get_collection_items retrieves the models inside that collection, again using the standard item card shape with full pagination metadata including has_next and has_prev.
- Build a 3D print discovery feed filtered by category and sorted by most popular downloads
- Aggregate a designer's full portfolio by chaining get_user_profile with get_user_models
- Track community engagement on a model by polling get_model_comments and get_model_prints over time
- Catalog free vs. paid model availability across Pinshape categories using the pricing filter in search_models
- Mirror a user's curated collections by fetching get_user_collections then get_collection_items for each
- Extract license metadata from get_model_details to filter models eligible for commercial use
- Analyze creator influence by comparing followers, likes, and download_count across user profiles
| 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.