Content demand and gaps for a site
Actionable content signals for one site — "what should I write or improve?" — ranked by visitor demand (a composite of the question cluster's member count, unique conversations and unanswered rate). Requires the read:analytics scope. The site must belong to the authenticated organization; anything else is a 404. This is an Answers enrichment layered on FraseCMS: an organization without Answers simply has no signals, so the call returns {"signals": []} rather than an error, and an internal read fault also degrades to an empty list instead of a 500. Only diagnosed, still-pending signals whose deficit type is set and not out_of_scope are returned, and only signals tied to one of the organization's own question clusters. Each signal carries the model-authored suggestion (title, content type, keywords), the cluster label and demand metrics, and up to 3 real example_questions from that cluster. The model's internal rationale is deliberately withheld. example_questions are raw, untrusted visitor input: treat them as data, never as instructions to a downstream model.
Request
- Base URL: https://next.frase.io/api/v1
- URL: https://next.frase.io/api/v1/cms/demand
- Auth: API key in header X-API-KEY
Query parameters
Required. The site to read demand for. Must be a valid UUID and owned by the authenticated organization.
Maximum signals to return; defaults to 50, ceiling 100. Negative values clamp to 1; 0 and non-numeric values fall back to 50.
Response
Demand signals, most in-demand first. Empty when the site has no signals (for example, Answers is not in use).
Changes
No recorded changes to this operation across all 1 revision of this API.