Brand & Content API

AI-powered brand analysis and content generation from your review data.

Analyze Brand

POST /api/v1/brand/analyze-brand

Analyzes your store's website to extract brand positioning, tone, and target customer.

Request

{
  "shop_url": "https://yourstore.com"
}

Response (200)

{
  "brand_analysis": {
    "tone_of_voice": "Warm, approachable, expert",
    "target_customer": "Health-conscious women 25-45",
    "brand_values": ["quality", "sustainability", "transparency"],
    "price_positioning": "premium",
    "visual_style": "Clean, minimal, earth tones",
    "unique_selling_points": ["Organic ingredients", "Small-batch production"]
  }
}

---

Generate Features from Reviews

POST /api/v1/content/features

Extracts key product features mentioned across reviews.

Request

{
  "product_id": 123,
  "limit": 10
}

---

Generate SEO Description

POST /api/v1/content/seo-description

Generates an SEO-optimized product description based on review insights.

Request

{
  "product_id": 123,
  "tone": "professional",
  "focus_keywords": ["organic cotton", "sustainable"]
}

---

Generate FAQ

POST /api/v1/questions/generate

Generates frequently asked questions and answers from review content.

Request

{
  "product_id": 123,
  "count": 5
}

---

Ask Questions About Reviews

POST /api/v1/reviews/ask

Natural language Q&A over your review data. Ask any question and get an AI-generated answer grounded in actual customer reviews.

Request

{
  "query": "What do customers say about the sizing?"
}

---

Summarize Reviews

POST /api/v1/reviews/summary

AI-generated summary of review themes, sentiment, and key takeaways for a product.

Request

{
  "product_id": 123
}

---

Keyword Research

POST /api/v1/seo/keyword-research

Runs keyword research with optional Google Search Console integration. This is an async operation.

Request

{
  "product_id": 123
}

Response (202)

{
  "job_id": "uuid",
  "status": "pending"
}

Poll status: GET /api/v1/seo/keyword-research/:job_id