# Theresanaiforthat — 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 discover AI tools across different tasks, get detailed information about specific tools, browse available deals, and stay updated on the latest tools. Find the perfect AI solution for your needs by filtering by task category or checking featured and trending tools.

**Category:** Developer Tools | **Website:** [theresanaiforthat.com/](https://theresanaiforthat.com/) | **Docs:** [parse.bot/marketplace/47ea64f3-3640-4080-a6c1-079676650d51/theresanaiforthat-com-api](https://parse.bot/marketplace/47ea64f3-3640-4080-a6c1-079676650d51/theresanaiforthat-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get deals

Retrieve currently available deals and discounts on AI tools. Returns deal objects including the tool name, discount amount/type, task category, slug, and description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get featured tools

Get currently featured/promoted AI tools from the newsletter section. Returns a list of sponsored tools with their details including name, task category, slug, and description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/get_featured_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get task tools

Get AI tools related to a specific task category by searching for the task name. Uses the search API to find tools matching the given task. Returns tool objects with basic metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `task_name` | string | Yes | Name of the task category to search (e.g. 'Creativity', 'Writing', 'Sales'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/get_task_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task_name":"<string>"}'
```

### Get tool details

Retrieve full details for a specific AI tool by its slug identifier. Returns name, description, overview, company info, and associated task tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Tool slug identifier (e.g. 'chatgpt', 'midjourney'). Obtainable from search_tools results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/get_tool_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List agents

List all AI agents from the dedicated agents page. Returns agent records with name, one-line description, detail page URL, pricing model, and view/save counts. Typically returns 70-80 agents per call in a single page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/list_agents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List tasks

List top-level task categories available on the site, sorted by saves count descending. Returns task names, slugs, subscriber counts, saves, and tool counts. Returns up to 80 tasks per call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/list_tasks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List tools latest

Get the latest AI tools from the home feed. Returns recently released or promoted tools with their basic details including name, task category, slug, and short description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/list_tools_latest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search tools

Search for AI tools by keyword or task name. Returns matching AI tool records and related task categories. Results are ordered by relevance score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'chatgpt', 'image generation', 'writing'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-theresanaiforthat-com-api-47ea64f3/search_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```