Find Content Opportunities

Workflow contract for finding market-backed content opportunities across AI search, SEO keywords, trends, Reddit, YouTube, and citations.

Overview

Workflow endpoints 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/content-opportunities

$0.58 · flat per call

Parameters

`topic`required	string	Market, niche, product category, or audience to research.
`audience`optional	string	Optional target audience or ICP.
`brand`optional	string	Optional brand/domain to account for in the opportunity scan.
`competitors`optional	string[]	Competitor brands/domains to compare against.
`country`optional	string	ISO-2 country code for localized SEO keyword data. Default: `"us"`.
`channels`optional	array of enum (ai_search \| seo_keywords \| google_trends \| reddit \| youtube)	Optional data sources to include. Defaults to all relevant sources.
`models`optional	array of enum (chatgpt \| claude \| perplexity \| gemini \| google_ai_overview)	Optional model subset. Omit to query all five AI surfaces (chatgpt, claude, perplexity, gemini, google_ai_overview). Pass ["perplexity"] or ["perplexity","claude"] when the user asks for specific surfaces or wants to reduce cost.

Request

curl https://api.cite42.dev/v1/workflows/content-opportunities \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "topic": "AI search optimization for SaaS", "competitors": ["Peec AI", "Profound"] }'

Response

{
  "status": "workflow_result",
  "workflow": "find_content_opportunities",
  "summary": "Find content opportunities by combining AI visibility, SEO keyword demand, Google Trends, Reddit questions, and YouTube signals.",
  "results": [
    { "endpoint": "/v1/search", "tool": "cite42_search", "ok": true, "why": "...", "data": { "query": "...", "results": [ "…per-model answers with citations…" ] } },
    { "endpoint": "/v1/keywords", "tool": "cite42_keywords", "ok": true, "why": "...", "data": { "keyword": "...", "volume": 4400, "cpc": 6.2, "ideas": [ "…" ] } },
    { "endpoint": "/v1/reddit/trends", "tool": "cite42_reddit_trends", "ok": true, "why": "...", "data": { "risingThreads": [ "…" ], "painPoints": [ "…" ], "repeatedQuestions": [ "…" ] } }
  ]
}