FurniMesh APIfurnimesh.com ↗
Access FurniMesh's 3D furniture model library via API. Search by keyword, browse by category, and retrieve polygon counts, formats, and download metadata.
What is the FurniMesh API?
The FurniMesh API exposes 3 endpoints for querying the FurniMesh free 3D furniture model library. Use search_models to run full-text queries across the catalog, list_models to paginate through category trees like seating, lighting, or storage, and get_model to pull per-model detail including polycount, vertex count, available file formats with byte sizes, and category hierarchy.
curl -X GET 'https://api.parse.bot/scraper/678d7c7f-1c9d-4277-a0b0-17bae4edc97a/search_models?page=1&query=sofa' \ -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 furnimesh-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.
"""Walkthrough: FurniMesh SDK - search, browse, and inspect 3D furniture models."""
from parse_apis.furnimesh_com_api import FurniMesh, ModelNotFound
client = FurniMesh()
# Search for sofa models, capped at 5 total results
for model in client.models.search(query="sofa", limit=5):
print(model.title, f"({model.downloads} downloads)", model.formats)
# Browse tables category via constructible Category
for table in client.category(path="tables").list(limit=3):
print(table.title, table.url)
# Drill into a specific model for full detail
detail = client.model_details.get(model_path="sofas/sectional/a-large-contemporary-lowprofile-curved-modular-sectional-6cm465")
print(detail.name, detail.category)
print(f" Polygons: {detail.properties.polycount}, Vertices: {detail.properties.vertex_count}")
for fmt in detail.formats:
print(f" {fmt.format}: {fmt.content_size_bytes} bytes, free={fmt.is_free}")
# Handle a model that does not exist
try:
client.model_details.get(model_path="sofas/sofa/nonexistent-model-xyz")
except ModelNotFound as exc:
print(f"Model not found: {exc.model_path}")
print("exercised: models.search / category.list / model_details.get / ModelNotFound")
Full-text search across FurniMesh 3D furniture model library. Returns matching models with title, available formats, download count, and image URL. Results are auto-iterated across pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search query for furniture 3D models. |
{
"type": "object",
"fields": {
"page": "integer",
"query": "string",
"total": "integer",
"models": "array of model summaries",
"has_next_page": "boolean"
},
"sample": {
"data": {
"page": 1,
"query": "sofa",
"total": 48,
"models": [
{
"url": "https://furnimesh.com/library/sofas/sectional/a-large-contemporary-lowprofile-curved-modular-sectional-6cm465/",
"slug": "a-large-contemporary-lowprofile-curved-modular-sectional-6cm465",
"tags": [
"Textures",
"AI-enhanced"
],
"title": "A large, contemporary low-profile curved modular sectional sofa, uphol…",
"formats": [
"GLB",
"OBJ",
"SKP",
"BLEND"
],
"downloads": 53,
"image_url": "https://storage.googleapis.com/furnimesh-3d/original/xdVAsfEigwjWC81c_GBMR.jpeg"
}
],
"has_next_page": false
},
"status": "success"
}
}About the FurniMesh API
Search and Browse the Catalog
The search_models endpoint accepts a query string and an optional page integer, returning an array of model summaries alongside a total count and a has_next_page flag for cursor-style iteration. Each summary includes the model title, available formats, download count, and a thumbnail image URL. The list_models endpoint mirrors this shape but filters by category path — top-level values include seating, sofas, tables, beds, storage, lighting, bathroom, decor, kitchen — and also supports subcategory paths for narrower browsing.
Model Detail
Once you have a model_path from either listing endpoint (structured as category/subcategory/slug), pass it to get_model to retrieve the full record. The response includes a formats array where each entry carries the format name, a human-readable description, content_size_bytes, and an is_free flag. The properties object exposes polycount, vertexCount, materialCount, hasUV, and animationCount — enough to programmatically filter assets by complexity before downloading. Additional fields include date_published, keywords, description, and thumbnail_url.
Data Shape and Scope
All three endpoints return structured JSON with consistent pagination using page and has_next_page. The catalog covers furniture and interior design assets: chairs, sofas, tables, beds, storage units, lighting fixtures, bathroom fittings, kitchen items, and decorative objects. Format availability varies per model; the is_free flag on each format entry indicates whether that specific file is available without a paid account on the source site.
The FurniMesh API is a managed, monitored endpoint for furnimesh.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when furnimesh.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 furnimesh.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?+
- Filter 3D furniture assets by polygon count before importing into a real-time rendering engine using the
polycountfield fromget_model. - Build a catalog browser that groups models by category using
list_modelswith top-level category slugs likelightingorstorage. - Check which file formats are available and their sizes using the
formatsarray before initiating a download workflow. - Index the FurniMesh library into a searchable internal database by iterating
search_modelspages for broad keyword terms. - Filter assets with UV maps by inspecting the
hasUVproperty, ensuring compatibility with texture-painting pipelines. - Surface furniture model thumbnails and metadata inside a design tool or mood-board application using
thumbnail_urlandkeywords. - Identify newly published models by sorting or filtering on the
date_publishedfield returned byget_model.
| 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.
Does FurniMesh have an official developer API?+
What does the `formats` array in `get_model` actually tell me?+
formats array includes the format name (e.g. FBX, OBJ, Blender), a short description, content_size_bytes so you know the file size before downloading, and an is_free boolean that reflects whether that specific format file is freely accessible on FurniMesh.Can I retrieve user reviews or ratings for models?+
Does the API return direct download links for model files?+
get_model endpoint returns metadata about each format — name, description, size in bytes, and whether it is free — but does not return direct file download URLs. You can fork this API on Parse and revise it to add a download-link resolution endpoint.How does pagination work across the listing and search endpoints?+
search_models and list_models accept an optional page integer parameter and return a has_next_page boolean in each response. Increment page and repeat the request while has_next_page is true to iterate through the full result set. The total field in search_models also gives the aggregate match count.