# Toolify — 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 browse premium .ai domain names available on the Toolify marketplace, filtering by keywords, categories, prices, and domain attributes to find the perfect domain for your project. Explore curated domain listings organized by category to discover valuable .ai domains suited to your needs.

**Category:** Developer Tools | **Website:** [toolify.ai/](https://toolify.ai/) | **Docs:** [parse.bot/marketplace/73bb8077-2dd3-478d-86c3-fa22a0bee23b/toolify-ai-api](https://parse.bot/marketplace/73bb8077-2dd3-478d-86c3-fa22a0bee23b/toolify-ai-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-toolify-ai-api-73bb8077/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_list

Retrieve the full category tree with groups, subcategories, and tool counts. Each group contains a title, handle, and values array of subcategories. Also returns a flat all_category list and total category_count.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_category_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_new_tools

Retrieve the latest launched AI tools. Returns the 10 most recently added tools with their categories. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_new_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tool_detail

Get comprehensive details for a specific AI tool by its handle/slug. Returns name, description, website URL, rating, tags, product info sections, and FAQ. Each tool page is a separate fetch.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Tool handle/slug (e.g. 'chatgpt-4', 'midjourney'). Use handles from search_tools or get_trending_tools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_tool_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>"}'
```

### get_tools_by_category

List tools within a specific category. Returns up to 50 tools matching the given category handle with name, handle, website, and description.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_handle` | string | Yes | Category handle/slug from get_category_list results (e.g. 'ai-chatbot', 'ai-blog-generator') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_tools_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_handle":"<string>"}'
```

### get_top_articles

Retrieve top AI articles and blog posts. Returns a paginated article list with metadata including title, description, image URL, and timestamps.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_top_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trending_tools

Get top trending AI tools ranked by monthly traffic. Returns up to 50 tools with visit counts, tags, and website URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-toolify-ai-api-73bb8077/get_trending_tools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_tools

Full-text search across the AI tools directory. Returns matching tools with handle, name, description, and URL. Deduplicates results by handle and caps at 50.

**Estimated cost:** Metered

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

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