Pinshape APIpinshape.com ↗
Access Pinshape 3D printable model metadata, user profiles, collections, community prints, and comments via 9 structured API endpoints.
What is the Pinshape 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.
curl -X GET 'https://api.parse.bot/scraper/98dc5891-041d-4bb8-91fe-a165dff9b8fa/search_models?nsfw=0&page=1&sort=most-popular&limit=5&query=robot&pricing=all&category=Art' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace pinshape-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Pinshape API — search 3D models, drill into details, explore creators."""
from parse_apis.pinshape_api import Pinshape, Sort, Category, ModelNotFound
client = Pinshape()
# Search for free toy models sorted by popularity
for model in client.models.search(query="robot", sort=Sort.MOST_POPULAR, limit=3):
print(model.title, model.likes_count, model.download_count)
# Drill into the first result for full details
summary = client.models.search(query="elephant", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.license, detail.tags)
# Browse comments on this model
for comment in detail.comments.list(limit=3):
print(comment.username, comment.content[:60])
# Check community prints
for p in detail.prints.list(limit=2):
print(p.username, p.rating, p.print_settings.material_type)
# Fetch a user profile and explore their uploads
user = client.users.get(user_id="1194", username="le-fabshop")
print(user.display_name, user.followers, user.location)
for item in user.models.list(limit=3):
print(item.title, item.price)
# Browse a collection by constructing it from its ID
coll = client.collection(id="222")
for item in coll.items.list(limit=2):
print(item.title, item.creator.username)
# Typed error handling for a model lookup
try:
bad = client.models.search(query="nonexistent_xyz_zzz", limit=1).first()
if bad:
bad.details()
except ModelNotFound as exc:
print(f"Model not found: item_id={exc.item_id}, slug={exc.slug}")
print("exercised: models.search / details / comments.list / prints.list / users.get / user.models.list / collection.items.list")Search for 3D printable models by keyword and filters. Returns paginated results with item cards including creator info, pricing, and engagement counts. Omitting the query returns all models matching the specified filters.
| Param | Type | Description |
|---|---|---|
| nsfw | integer | NSFW filter. 0 excludes NSFW, 1 includes NSFW. |
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| limit | integer | Number of items per page. |
| query | string | Search query string. |
| pricing | string | Pricing filter. |
| category | string | Category name to filter by. |
{
"type": "object",
"fields": {
"items": "array of model card objects 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": 2481,
"download_count": 35382,
"description_snippet": "We created this cute little articulated elephant last month for our friends i..."
}
],
"pagination": {
"has_next": true,
"total_items": 649,
"total_pages": 130,
"current_page": 1
}
},
"status": "success"
}
}About the Pinshape API
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.
The Pinshape API is a managed, monitored endpoint for pinshape.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pinshape.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official pinshape.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.