Overview
Base URL:
https://dzp3dexplorer.com/v1/
- CORS:
Access-Control-Allow-Origin: * - Methods:
GET,HEAD,OPTIONS - Responses: JSON (except preview, which redirects)
- Live discovery:
GET /v1/
Rate limits
Per client IP.
| Bucket | Per minute | Per day |
|---|---|---|
JSON (/v1/, search, model) |
60 | 5,000 |
| Preview redirect | 120 | 10,000 |
Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
On exceed: 429 with Retry-After and
{"error":"...","status":429}.
Endpoints
| Method | Path | Purpose |
|---|---|---|
GET |
/v1/ |
Discovery (endpoints, limits, examples) |
GET |
/v1/search |
Search or browse models |
GET |
/v1/models/{id} |
Full model metadata by id |
GET |
/v1/models?path= |
Full model metadata by relative path |
GET |
/v1/models/{id}/preview |
302 to best still preview image |
GET /v1/search
Same query language as the website.
| Param | Default | Notes |
|---|---|---|
q |
empty | Free text or fielded (selections:door, texture:moss, …) |
path |
empty | Folder prefix, e.g. weapons_takistan/firearms |
limit |
25 |
Max 100 |
offset |
0 |
Pagination |
exp |
empty | Comma-separated packs: vanilla, livonia, takistan, sakhal |
curl "https://dzp3dexplorer.com/v1/search?q=leeEnfield&limit=5"
curl "https://dzp3dexplorer.com/v1/search?path=gear/containers&limit=10"
curl "https://dzp3dexplorer.com/v1/search?exp=takistan&limit=10"
Each result includes preview (url + source:
turntable | sams | izurvive) when available,
plus preview_url (stable redirect) and page_url.
GET /v1/models/{id}
Full model metadata: LODs, selections, textures, materials, proxies, bones, animations,
ODOL flags, turntable info. Large lists are capped (e.g. first 500 selections) with
*_total and *_truncated.
curl "https://dzp3dexplorer.com/v1/models/42276"GET /v1/models?path=
Same payload, looked up by relative path (case-insensitive).
curl "https://dzp3dexplorer.com/v1/models?path=weapons_takistan/firearms/leeEnfield/leeEnfield.p3d"GET /v1/models/{id}/preview
302 redirect to the best still image (turntable poster preferred, else Sam / iZurvive).
You can also hotlink the absolute preview.url from JSON responses directly.
curl -I "https://dzp3dexplorer.com/v1/models/42276/preview"