Brand & Content API

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

Availability: the brand analysis, content generation, and question generation endpoints in this section are entitlement-gated; without the required AI content entitlement they return 403 entitlement_required. Better and Studio include these entitlements. On legacy plans (no longer sold), they are available on Growth and above, and on legacy Pro and Enterprise; stores on the legacy Starter plan do not have them. The review Q&A endpoints (POST /reviews/ask, POST /reviews/summary) are not entitlement-gated, but like every LLM-backed endpoint in this section they require an active paid subscription (402 subscription_required otherwise). The Free plan does not include them, and neither does a cancelled store (cancelling returns the store to Free), so those stores get 403 entitlement_required on the gated endpoints on top of the 402 above. Keyword-research status reads are available to any authenticated store. See Pricing.

All three generation endpoints (/content/features, /content/seo-description, /questions/generate) take the store from the API key: whatever store_id you send in the body is overwritten with the authenticated store, so a request can never read another store's reviews. Sending it alongside external_product_id is still what opts the request into review-grounded generation — omit both to generate from the topic alone. A user-level key that is not bound to a store receives 403.

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