Map AI Prompts

Workflow contract for discovering buyer prompts, question clusters, and tracking prompts from market data signals.

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/ai-prompt-map

$0.58 · flat per call

Parameters

`topic`required	string	Market, product category, buyer problem, or audience to map prompts for.
`audience`optional	string	Optional target audience or ICP.
`brand`optional	string	Optional brand/domain to include in prompt tracking recommendations.
`competitors`optional	string[]	Competitor brands/domains to include in comparison prompts.
`country`optional	string	ISO-2 country code for localized SEO keyword data. Default: `"us"`.
`timeframe`optional	string	Trend window for demand checks. Default: `"past_12_months"`.
`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/ai-prompt-map \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "topic": "AI search optimization for SaaS", "audience": "B2B SaaS founders", "competitors": ["Peec AI", "Profound"] }'

Response

{
  "status": "workflow_result",
  "workflow": "map_ai_prompts",
  "summary": "Discover buyer, creator, and market prompts worth tracking by combining SEO demand, Google Trends, AI answers, citations, and audience-language 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": [ "…" ] } }
  ]
}