BrandScout API

Check domain and social media username availability for any brand name. Free, open, and AI-friendly.

Overview

Base URL: https://brandscout.dev

All responses are JSON. CORS is enabled for all origins. No authentication required (API key support coming soon).

Endpoints

GET/api/v1/check?q=brandname

Quick check via query parameter. Ideal for curl and AI agents.

POST/api/v1/check

Check with JSON body.

Request Body
{
  "query": "mybrandname"
}

Response Format

200 OK
{
  "query": "mybrandname",
  "name": "mybrandname",
  "score": 75,
  "description_for_ai": "Brand \"mybrandname\": mybrandname.com is available; usernames taken on GitHub, Reddit.",
  "domains": [
    { "domain": "mybrandname.com", "tld": ".com", "status": "available" },
    { "domain": "mybrandname.io", "tld": ".io", "status": "taken" }
  ],
  "usernames": [
    { "platform": "GitHub", "username": "mybrandname", "status": "available", "profileUrl": "https://github.com/mybrandname" },
    { "platform": "Reddit", "username": "mybrandname", "status": "taken", "profileUrl": "https://www.reddit.com/user/mybrandname" }
  ],
  "suggestions": ["mybrandname_", "getmybrandname", "mybrandnamehq"]
}

score — 0-100, higher means more available across domains & platforms

description_for_ai — Natural language summary for LLMs

status — "available", "taken", or "unknown"

Filtering

Filter results by TLD or platform using query parameters:

Filter examples
# Only check .com and .io
GET /api/v1/check?q=mybrand&tlds=com,io

# Only check GitHub and Reddit
GET /api/v1/check?q=mybrand&platforms=github,reddit

# Combine filters
GET /api/v1/check?q=mybrand&tlds=com&platforms=github

Available TLDs: com, net, org, co, io, ai, app

Available platforms: GitHub, Reddit, Pinterest, Twitch, Medium, Vimeo

Rate Limits

30 requests per minute per IP address. If exceeded, you'll receive a 429 response. No API key required.

Authentication

Currently no authentication is required. You can optionally pass an X-API-Key header — it will be recognized in the future for higher rate limits.

Examples

curl

# GET
curl "https://brandscout.dev/api/v1/check?q=mybrandname"

# POST
curl -X POST https://brandscout.dev/api/v1/check \
  -H "Content-Type: application/json" \
  -d '{"query": "mybrandname"}'

# With filters
curl "https://brandscout.dev/api/v1/check?q=mybrand&tlds=com,io&platforms=github"

Python

python
import requests

# GET
r = requests.get("https://brandscout.dev/api/v1/check", params={"q": "mybrandname"})
data = r.json()
print(data["description_for_ai"])

# POST
r = requests.post("https://brandscout.dev/api/v1/check", json={"query": "mybrandname"})
data = r.json()
for d in data["domains"]:
    print(f"{d['domain']}: {d['status']}")

JavaScript / fetch

javascript
// GET
const res = await fetch("https://brandscout.dev/api/v1/check?q=mybrandname");
const data = await res.json();
console.log(data.description_for_ai);

// POST
const res = await fetch("https://brandscout.dev/api/v1/check", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ query: "mybrandname" }),
});
const data = await res.json();

OpenAPI Spec

A full OpenAPI 3.0 spec is available for AI agents, ChatGPT plugins, and code generation:

Try It — API Sandbox

Test the API right from your browser. Enter a brand name and see the raw JSON response.

GET/api/v1/check?q=

Error Handling

Error response format
{
  "error": "Missing required query parameter: q"
}

// Status codes:
// 400 — Bad request (missing/invalid parameters)
// 429 — Rate limit exceeded
// 500 — Server error