---
title: "Idempotently adds a business by normalized domain, scrapes the site, and seeds ~20 proposed prompts from llms.txt/title/H1 (0 burn until track_prompt confirms ~5). Returns brand_collision_warning for homonym-prone names. Free (no check debit). Requires business:create and an all-businesses key."
method: POST
path: "/add_business"
tags: ["action"]
---

# Idempotently adds a business by normalized domain, scrapes the site, and seeds ~20 proposed prompts from llms.txt/title/H1 (0 burn until track_prompt confirms ~5). Returns brand_collision_warning for homonym-prone names. Free (no check debit). Requires business:create and an all-businesses key.

`POST /add_business`

## Request

- Base URL: `https://scope.online/v1`
- URL: `https://scope.online/v1/add_business`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, uri, required: Canonical public website URL
  - `name` string, required: Business name
  - `city` string: City
  - `state` string: State or region
  - `industry` string: Industry

## Response `200`

Tool payload. `meta` holds tldr, next[], pagination cursors, and request_id.

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Quota or over-committed.
- `403`: Missing scope or Growth required.
- `404`: Unknown tool or resource.
- `405`: Wrong HTTP method for this tool.
- `429`: Rate limited (10 action calls / 60s per key; reads are higher).
- `503`: Temporary infrastructure limit — retry with retry_after.

---

[API](https://skmtc.dev/scope/apis/scope-api-2.md) · [All operations](https://skmtc.dev/scope/apis/scope-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/scope/apis/scope-api-2/revisions/2f01893f6e5c?raw)