# Turbosquid — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/turbosquid/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/turbosquid/get-free-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/turbosquid/get-model-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/turbosquid/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/turbosquid/search-models \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/turbosquid/search-textures \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.