# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/namegrep/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/namegrep/count-combinations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/namegrep/search-domains \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"pattern":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.