# Dotdb — 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 domains and uncover keyword insights to research competitor strategies and domain market intelligence. Get detailed domain metadata, keyword reports, and pricing information to inform your SEO and business decisions.

**Category:** Developer Tools | **Website:** [dotdb.com/](https://dotdb.com/) | **Docs:** [parse.bot/marketplace/6d60c8a4-5406-4ee6-8885-5c12bba84a06/dotdb-com-api](https://parse.bot/marketplace/6d60c8a4-5406-4ee6-8885-5c12bba84a06/dotdb-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-dotdb-com-api-6d60c8a4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get domain metadata

Fetch the meta title, description, and favicon URL from an external domain by loading its homepage. Connects directly to the target domain over HTTP. Returns empty strings for description/favicon when not found in the page HTML.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `domain` | string | Yes | Full domain name to fetch metadata from (e.g. 'google.com', 'pizza.com'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-dotdb-com-api-6d60c8a4/get_domain_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"<string>"}'
```

### Get keywords report

Retrieve the current top keywords and emerging keywords based on domain registration trends from dotDB. Top keywords are ordered by total exact-match domain count; emerging keywords are ordered by recent growth. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-dotdb-com-api-6d60c8a4/get_keywords_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get pricing

Get the full pricing comparison table for dotDB subscription plans. Returns all feature rows with values for each tier: Guest, Free Member, Basic, Pro, Expert, and Enterprise. Empty string indicates the feature is included (checkmark on site) or not applicable for that tier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-dotdb-com-api-6d60c8a4/get_pricing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search domains

Search for domains by keyword on dotDB. Returns the first matching keyword from the database and its registered TLD extensions. The match may be a longer string containing the keyword (e.g. searching 'pizza' may return '00100pizza'). Position is fixed to 'any'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keyword` | string | Yes | Search keyword to find matching domain registrations (e.g. 'pizza', 'saas', 'cloud'). |

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