# Extract a brand from its domain: POST /v1/brand/extract

A site's brand read from its pages: essence, voice, positioning, ideal customer, values and visual identity.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 2, measured per run
- Answers at once.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| domain | body | string | yes | Any public site, such as example.com.; at most 253 characters |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/brand/extract \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"tally.so"}'
```

## Response (a real call, 2026-11-12, trimmed)

```json
{
  "data": {
    "domain": "tally.so",
    "url": "https://tally.so",
    "brand": {
      "essence": "Tally makes creating professional online forms simple: type your questions like you would in a document, with no coding required. It offers unlimited forms and submissions for free within its fair…",
      "voice": {
        "adjectives": [
          "clear",
          "friendly",
          "playful",
          "reassuring"
        ],
        "description": "Tally sounds approachable and direct, making form creation feel easy without glossing over practical details like fair use and data privacy.",
        "write_like": [
          "Use plain language that makes getting started feel effortless.",
          "Describe form creation as typing questions and adding blocks.",
          "Pair simple benefits with clear, specific explanations.",
          "Keep the tone warm and lightly playful."
        ],
        "avoid": [
          "Avoid technical jargon when a plain explanation will do.",
          "Avoid implying that the free plan has no limits; mention fair usage guidelines.",
          "Avoid exaggerated promises about results or conversion.",
          "Avoid stiff, formal, or pressure-heavy sales language."
        ]
      },
      "positioning": {
        "statement": "Tally is a simple, no-code online form builder that lets people create professional forms by typing, with unlimited forms and submissions free within fair usage guidelines.",
        "differentiators": [
          "A document-like editor: create forms by typing questions and inserting blocks.",
          "Unlimited forms and submissions at no cost within fair usage guidelines.",
          "Privacy-focused handling, including European hosting, GDPR compliance, no cookie-tracking, and encryption in transit and at rest."
        ]
      },
      "visual": {
        "logo_url": "https://tally.so/images/logo_v2.png",
        "colors": [
          "#0070D7",
          "#33125C",
          "#FFFFFF",
          "#37352F",
          "#F81CE5"
        ],
        "vibe": "Clean, playful forms with expressive floating faces and a document-like feel.",
        "fonts": [
          "Inter"
        ]
      }
    }
  },
  "credits_charged": 2.04,
  "request_id": "6a2ec616-0671-4800-b3bb-cc50095a7699"
}
```

The whole API reference, for an agent: https://magistermarketing.com/docs/api.md