Extract Brand

Extract brand assets, colors, and other brand identity elements from a website URL. This is a queue-based API — it returns a requestId that can be used to check the status and retrieve results using the get-request-status API.

Endpoint

POST brand/extract

Authentication

Include your Enterprise API credentials in the request headers:

sivi-api-key: YOUR_API_KEY

Request Body Example

{
  "brandUrl": "https://sivi.ai"
}

Request Parameters

Parameter	Type	Required	Description
brandUrl	String	Yes	URL of the website to extract brand information from

Response

The API returns a requestId that can be used to check the status and retrieve results:

{
  "status": 200,
  "body": {
    "requestId": "sbhMkIZKCPp"
  }
}

Checking Request Status

Use the get-request-status API with the requestId to check the status and get the results:

GET general/get-request-status?queryParams={"requestId":"sbhMkIZKCPp"}

Final Response Format

Once the request is complete, the get-request-status API will return the following format:

{
  "status": 200,
  "body": {
    "status": "completed",
    "requestId": "sbhMkIZKCPp",
    "result": {
      "brandDetails": {
        "brandName": "Sivi",
        "brandDescription": "AI design generator for brands and layered vector based design generation",
        "brandUrl": "https://sivi.ai",
        "brandLogo": "https://sivi.ai/sivi-logo.png",
        "brandColors": ["#5662EC", "#EF9AB2"],
        "brandFonts": [],
        "brandPersona": {
          "emotions": ["happy"],
          "industry": "games",
          "audience": ["working mom", "working dad"],
          "designTags": ["minimal", "time management", "productivity", "health"]
        }
      }
    }
  }
}

Response Body Parameters

Parameter	Type	Description
brandName	String	Extracted name of the brand
brandDescription	String	Extracted description or tagline
brandUrl	String	Original URL provided in the request
brandLogo	String	URL to the extracted logo image
brandColors	Array	List of extracted brand colors in hex format
brandFonts	Array	List of detected fonts (may be empty if fonts cannot be determined)
brandPersona	Object	Brand persona details
brandPersona.emotions	Array	List of detected emotions
brandPersona.industry	String	Detected industry
brandPersona.audience	Array	List of detected target audience
brandPersona.designTags	Array	List of detected design tags

Note:: See all available options for each parameter in the Brand Persona Details section.

Error Responses

Authentication Error (401 Unauthorized)

{
  "status": 401,
  "body": {
    "message": "Failed to authenticate request. Please add sivi-api-key header in request"
  }
}

Invalid Input (422 Unprocessable Entity)

{
  "status": 422,
  "body": {
    "message": "Invalid input"
  }
}

Server Error (500 Internal Server Error)

{
  "status": 500,
  "body": {
    "message": "Server internal error"
  }
}

Usage Notes

• This API analyzes a website to extract brand elements automatically
• The extracted brand information can be used to create a brand identity using the Create Brand API
• The extraction process uses AI to identify logos, colors, and other brand elements
• Extraction quality depends on the website's structure and accessibility
• For best results, provide the homepage or brand guidelines page of the website