# Turbosquid — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and explore millions of 3D models and textures from TurboSquid's marketplace, viewing detailed specifications, pricing, and availability across different categories. Discover free models, filter by your needs, and access comprehensive product information to find the perfect assets for your projects.

**Category:** Marketplaces | **Website:** [turbosquid.com/](https://turbosquid.com/) | **Docs:** [parse.bot/marketplace/cef9bf97-1990-4399-9704-8d6cb3c07086/turbosquid-com-api](https://parse.bot/marketplace/cef9bf97-1990-4399-9704-8d6cb3c07086/turbosquid-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_free_models

Search for free 3D models on TurboSquid by keyword. Returns paginated results filtered to free models. Each page returns up to 96 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword for free 3D models. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/get_free_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### get_model_details

Get detailed specifications for a specific 3D model by its TurboSquid SKU or product URL. Returns format availability, polygon count, price, geometry type, and materials info. The SKU can be extracted from a product URL (trailing numeric segment).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_sku` | string | No | TurboSquid numeric SKU identifier (e.g. '1244267'). Either product_sku or product_url must be provided. |
| `product_url` | string | No | Full TurboSquid product URL (e.g. 'https://www.turbosquid.com/3d-models/3d-cars-games-model-1244267'). Either product_sku or product_url must be provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/get_model_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_sku":"<string>","product_url":"<string>"}'
```

### list_categories

Get a curated list of popular 3D model categories available on TurboSquid. Returns a static list of category names and URL slugs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_models

Search for 3D models on TurboSquid by keyword. Returns paginated results with model title, SKU, price, URL, and thumbnail. Results are ordered by relevance. Each page returns up to 50 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword for 3D models. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/search_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### search_textures

Search for textures on TurboSquid by keyword. Returns paginated results with texture title, SKU, price, URL, and thumbnail. Each page returns up to 50 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword for textures. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-turbosquid-com-api-cef9bf97/search_textures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```
