Topic Demand API workflow

POST /v1/workflows/topic-demandAbout Topic Demand

Workflow endpoint that checks demand for a topic across SEO keywords, Google Trends, current AI answers and audience conversations in one call.

Overview

Workflow tools run their primitives in parallel and return each primitive's full output, labeled per source. Pricing is calculated from the primitives that ran successfully plus the selected model rates: failed or skipped steps are not charged.

Reference

POST/v1/workflows/topic-demand

$0.57 · flat per call

Parameters

topicstringrequired
Topic, keyword, category, or audience demand to analyze.
countrystringoptional
ISO-2 country code for localized SEO keyword data. Default: "us".
timeframestringoptional
Trend window for demand checks. Default: "past_12_months".
modelsenum[]optional
AI surfaces to query, each billed separately; pass a subset when the user names surfaces or wants a lower cost. Omit for the defaults (chatgpt, perplexity, gemini); fullSweep queries all five. google_ai_overview accepts queries up to 700 characters, the others 2000.
Values:chatgptclaudeperplexitygeminigoogle_ai_overview
fullSweepbooleanoptional
Query all five AI surfaces (adds claude and google_ai_overview) for full cross-surface coverage, at a higher cost. Ignored when models is given.

Request

curl https://www.cite42.dev/api/v1/workflows/topic-demand \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic":"AI-powered CRM","timeframe":"past_12_months"}'

Response

{
  "status": "workflow_result",
  "workflow": "analyze_topic_demand",
  "summary": "Measure demand across search, trends, AI answers, and audience conversations.",
  "input": {
    "topic": "AI-powered CRM",
    "timeframe": "past_12_months"
  },
  "results": [
    {
      "endpoint": "/v1/trends",
      "tool": "cite42_trends",
      "why": "Check interest over time and rising queries.",
      "data": {
        "term": "AI-powered CRM",
        "trend": "rising",
        "interestOverTime": [
          {
            "date": "2026-07-13",
            "value": 72
          }
        ],
        "risingQueries": [
          "AI sales automation",
          "CRM copilot"
        ],
        "topQueries": [
          "AI CRM for startups"
        ]
      },
      "ok": true
    }
  ],
  "suggestedPrompt": "Summarize demand and recommend the strongest topic angle."
}