# Theresanaiforthat — 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 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.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.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.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.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.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.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.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.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.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>"}'
```