# Themewagon — 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.

> Discover and browse thousands of website themes and templates from ThemeWagon, with the ability to search by category, framework, or tag, and view detailed information like ratings, download counts, and user reviews. Filter results to find free or premium themes, explore editor's picks, and stay updated with the latest and most popular designs.

**Category:** Developer Tools | **Website:** [themewagon.com/](https://themewagon.com/) | **Docs:** [parse.bot/marketplace/97d4efd7-2ae6-418f-9345-e6a67eccde13/themewagon-com-api](https://parse.bot/marketplace/97d4efd7-2ae6-418f-9345-e6a67eccde13/themewagon-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-themewagon-com-api-97d4efd7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_themes

Returns a paginated list of all themes/templates. Supports sorting by date, popularity, and rating. Returns 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_all_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### get_editors_pick

Returns premium/featured themes as a curated editor's pick selection. The catalog is small and typically fits on a single page. Each theme includes title, slug, url, price, rating, thumbnail, and download_count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_editors_pick \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_free_themes

Returns all free themes with pagination. Returns 20 themes per page. Each theme includes title, slug, url, price, rating, thumbnail, and download_count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_free_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_latest_themes

Returns the most recently released themes, sorted by date descending. Returns 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_latest_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_popular_themes

Returns themes sorted by popularity descending. Returns 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_popular_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_premium_themes

Returns all premium/paid themes. The premium catalog is small and typically fits on a single page. Each theme includes title, slug, url, price, rating, thumbnail, and download_count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_premium_themes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_theme_detail

Returns full detail for a specific theme by its slug, including description, features, metadata, rating, and related themes. Provides comprehensive information about a single theme including version, frameworks, categories, tags, download count, and live preview URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Theme slug (e.g. phoenix, tailadmin, iportfolio). Obtainable from any theme listing endpoint's themes[*].slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_theme_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_theme_reviews

Returns user reviews for a specific theme. All reviews are returned in a single response without pagination. Each review includes author, rating, title, text, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Theme slug (e.g. phoenix, falcon, sparrow). Obtainable from any theme listing endpoint's themes[*].slug. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_theme_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_themes_by_category

Returns themes filtered by category slug. Returns 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Category slug (e.g. admin-dashboard, landing-website). Obtainable from list_categories endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_themes_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### get_themes_by_framework

Returns themes filtered by framework slug. Returns 20 themes per page. Each theme includes title, slug, url, price, rating, thumbnail, and download_count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Framework slug (e.g. tailwind-css, bootstrap-5, material-ui, next-js). Obtainable from list_frameworks endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_themes_by_framework \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### get_themes_by_tag

Returns themes filtered by tag slug. Returns 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Tag slug (e.g. animation, blog-template, accordions). Obtainable from list_tags endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-themewagon-com-api-97d4efd7/get_themes_by_tag \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### list_categories

Returns all available theme categories with their slugs and theme counts. The response contains an items array of category objects.

**Estimated cost:** Metered

_No parameters required._

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

### list_frameworks

Returns all available frameworks that themes can be filtered by. The response contains an items array of framework objects with name and slug.

**Estimated cost:** Metered

_No parameters required._

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

### list_tags

Returns all available tags with their slugs, descriptions, and theme counts. The response contains an items array of tag objects.

**Estimated cost:** Metered

_No parameters required._

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

### search_themes

Search themes by keyword. Returns paginated results with 20 themes per page. Each theme includes id, title, slug, url, price, rating, rating_count, and thumbnail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. dashboard, portfolio, react). |

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