# Elements Envato — 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 browse millions of creative assets from Envato Elements, including stock photos, videos, music, fonts, and templates across all categories. Get detailed information about specific items, pricing plans, and discover new content through keyword search and category browsing.

**Category:** Marketplaces | **Website:** [elements.envato.com/](https://elements.envato.com/) | **Docs:** [parse.bot/marketplace/27ce6ea7-0800-490c-a234-d142460ca1b7/elements-envato-com-api](https://parse.bot/marketplace/27ce6ea7-0800-490c-a234-d142460ca1b7/elements-envato-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/elements-envato/`
**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 all categories

Returns all top-level item categories with their URL paths. Each category path can be passed to get_items_by_category or search_items. The list is stable (14 categories covering video templates, stock video, music, sound effects, graphic templates, graphics, presentation templates, photos, fonts, add-ons, web templates, CMS templates, 3D, and WordPress).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/elements-envato/get-all-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get item detail

Retrieve full details for a specific item by its URL path. Returns comprehensive item metadata including description, tags, categories, resolution, file attributes, as well as related items and other items by the same author. The item_path is obtainable from search_items or get_items_by_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_path` | string | Yes | The URL path of the item (e.g. '/high-quality-logo-3d-mockup-PVP7AZ3'). Obtainable from search_items or get_items_by_category results[*].url. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/elements-envato/get-item-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"item_path":"<string>"}'
```

### Get items by category

Browse items within a specific category with optional sorting and pagination. Returns paginated items (48 per page), refinement filters available for the category, and trending search terms. Use category paths from get_all_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | The URL path of the category, as returned by get_all_categories (e.g. '/graphic-templates', '/audio', '/fonts'). |
| `page` | integer | No | The page number to retrieve. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/elements-envato/get-items-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","page":"<integer>","sort_by":"<string>"}'
```

### Get pricing plans

Get a summary of current subscription pricing plans. Returns a link to the pricing page and a text note describing available plans and their approximate costs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/elements-envato/get-pricing-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search items

Search for items by keyword within a specific category. Returns paginated results (48 per page) with trending/related search suggestions. A category_path is required because the site's search only returns results within a category context.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category path to search within, as returned by get_all_categories (e.g. '/graphic-templates', '/audio', '/photos'). |
| `page` | integer | No | The page number to retrieve. |
| `query` | string | Yes | The search keyword or phrase. |
| `sort_by` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/elements-envato/search-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","page":"<integer>","query":"<string>","sort_by":"<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.