# Namegrep — 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 for available domain names across .com, .net, .org, .co, and .io extensions using regular expression patterns to find the perfect match for your project. Instantly discover which domain variations are currently available so you can register your ideal web address before someone else does.

**Category:** Developer Tools | **Website:** [namegrep.com/](https://namegrep.com/) | **Docs:** [parse.bot/marketplace/f5160805-075b-4218-b631-2ac75c2bea1e/namegrep-com-api](https://parse.bot/marketplace/f5160805-075b-4218-b631-2ac75c2bea1e/namegrep-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-namegrep-com-api-f5160805/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### count_combinations

Returns the total count of domain labels matching a regex pattern without fetching per-TLD availability. Useful for estimating result size before running a full search_domains query — patterns producing over 50,000 matches will only return a count from search_domains anyway.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pattern` | string | Yes | Regular expression pattern to match domain names against (e.g. '^tech[a-z]{2}$' for 6-letter names starting with 'tech'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namegrep-com-api-f5160805/count_combinations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pattern":"<string>"}'
```

### search_domains

Regex search over the domain-name dictionary. Returns all matching second-level labels (up to 50,000) with per-TLD registration status for .com, .net, .org, .co, and .io. The pattern is a PCRE-style regex matched against the full label (anchor with ^ and $ for exact length). Results are returned in a single page ordered alphabetically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pattern` | string | Yes | Regular expression pattern to match domain names against (e.g. '^tech[a-z]{2}$' for 6-letter names starting with 'tech'). Must produce fewer than 50,000 matches. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-namegrep-com-api-f5160805/search_domains \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pattern":"<string>"}'
```