AI Prompt Research API workflow
POST /v1/workflows/ai-prompt-mapAbout AI Prompt Research
Workflow endpoint that maps the prompts buyers ask AI into question clusters and trackable prompts, built from search and audience signals.
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/ai-prompt-map$0.82 · flat per call
Parameters
topicstringrequired
Market, product category, buyer problem, or audience to map prompts for.
audiencestringoptional
Optional target audience or ICP.
brandstringoptional
Optional brand/domain to include in prompt tracking recommendations.
competitorsstring[]optional
Competitor brands/domains to include in comparison prompts.
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/ai-prompt-map \
-X POST \
-H "Authorization: Bearer $CITE42_API_KEY" \
-H "Content-Type: application/json" \
-d '{"topic":"AI-powered CRM","audience":"startup teams","competitors":["Rival CRM","Legacy CRM"]}'Response
{
"status": "workflow_result",
"workflow": "map_ai_prompts",
"summary": "Discover buyer and market prompts worth tracking.",
"input": {
"topic": "AI-powered CRM",
"audience": "startup teams",
"competitors": [
"Rival CRM",
"Legacy CRM"
]
},
"results": [
{
"endpoint": "/v1/reddit/trends",
"tool": "cite42_reddit_trends",
"why": "Add what people discuss on Reddit, as summarized threads with source links.",
"data": {
"topic": "AI-powered CRM",
"timeframe": "past_30_days",
"provider": "reddit",
"subredditsSearched": [
"SaaS",
"sales"
],
"relevantThreads": [
{
"title": "Which AI CRM works for a small sales team?",
"subreddit": "SaaS",
"url": "https://www.reddit.com/r/SaaS/comments/example/which_ai_crm_works_for_a_small_sales_team/",
"permalink": "https://www.reddit.com/r/SaaS/comments/example/which_ai_crm_works_for_a_small_sales_team/",
"score": null,
"comments": null,
"createdAt": null,
"dateSource": "unknown",
"textSource": "gemini_url_context",
"excerpt": "We are a small sales team comparing AI CRMs. What was easiest to set up?",
"author": "example_founder",
"ageText": "2d ago",
"withinTimeframe": null,
"sampledComments": [
{
"author": "example_reader",
"ageText": "1d ago",
"text": "Setup time mattered more to our team than extra features."
}
],
"summary": "A thread on r/SaaS compares AI CRMs for small sales teams, with replies weighing quick setup against price per seat.",
"citationUrl": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/example-1",
"titleSource": "gemini_url_context"
},
{
"title": "crm onboarding takes too long for our team",
"subreddit": "sales",
"url": "https://www.reddit.com/r/sales/comments/example2/crm_onboarding_takes_too_long_for_our_team/",
"permalink": "https://www.reddit.com/r/sales/comments/example2/crm_onboarding_takes_too_long_for_our_team/",
"score": null,
"comments": null,
"createdAt": null,
"dateSource": "unknown",
"textSource": "google_grounded_summary",
"excerpt": "",
"author": null,
"ageText": null,
"withinTimeframe": null,
"sampledComments": [],
"summary": "A discussion on r/sales describes CRM onboarding that takes weeks for a two-person team and asks for lighter alternatives.",
"citationUrl": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/example-2",
"titleSource": "url_slug"
}
],
"risingThreads": [
{
"title": "Which AI CRM works for a small sales team?",
"subreddit": "SaaS",
"url": "https://www.reddit.com/r/SaaS/comments/example/which_ai_crm_works_for_a_small_sales_team/",
"permalink": "https://www.reddit.com/r/SaaS/comments/example/which_ai_crm_works_for_a_small_sales_team/",
"score": null,
"comments": null,
"createdAt": null,
"dateSource": "unknown",
"textSource": "gemini_url_context",
"excerpt": "We are a small sales team comparing AI CRMs. What was easiest to set up?",
"author": "example_founder",
"ageText": "2d ago",
"withinTimeframe": null,
"sampledComments": [
{
"author": "example_reader",
"ageText": "1d ago",
"text": "Setup time mattered more to our team than extra features."
}
],
"summary": "A thread on r/SaaS compares AI CRMs for small sales teams, with replies weighing quick setup against price per seat.",
"citationUrl": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/example-1",
"titleSource": "gemini_url_context"
},
{
"title": "crm onboarding takes too long for our team",
"subreddit": "sales",
"url": "https://www.reddit.com/r/sales/comments/example2/crm_onboarding_takes_too_long_for_our_team/",
"permalink": "https://www.reddit.com/r/sales/comments/example2/crm_onboarding_takes_too_long_for_our_team/",
"score": null,
"comments": null,
"createdAt": null,
"dateSource": "unknown",
"textSource": "google_grounded_summary",
"excerpt": "",
"author": null,
"ageText": null,
"withinTimeframe": null,
"sampledComments": [],
"summary": "A discussion on r/sales describes CRM onboarding that takes weeks for a two-person team and asks for lighter alternatives.",
"citationUrl": "https://vertexaisearch.cloud.google.com/grounding-api-redirect/example-2",
"titleSource": "url_slug"
}
],
"repeatedQuestions": [],
"painPoints": [],
"repeatedPhrases": [],
"mentionedProducts": [],
"analysis": {
"status": "complete",
"candidateCount": 6,
"relevantCount": 2,
"evidenceType": "grounded_summary"
},
"subredditBreakdown": [
{
"subreddit": "SaaS",
"posts": 1,
"totalScore": null,
"totalComments": null
},
{
"subreddit": "sales",
"posts": 1,
"totalScore": null,
"totalComments": null
}
],
"collection": {
"gemini": "ok",
"dataforseo": "not_requested",
"rss": "not_requested"
},
"coverage": {
"threadsFound": 2,
"pagesAttempted": 2,
"pagesRead": 1,
"threadsWithAge": 1,
"threadsWithinTimeframe": 0,
"threadsOutsideTimeframe": 0,
"threadsWithUnknownTimeframe": 2,
"threadsWithScore": 0,
"threadsWithCommentCount": 0,
"commentsRetrieved": 1,
"readingStatus": "partial"
},
"warnings": [
"Page fields and sampled comments were read by Gemini URL context, which may use cached pages. They are not independently verified quotes or current metrics.",
"Only 1 of 2 threads were read; unread threads retain model summaries and unavailable page fields.",
"Exact publication dates are unavailable. Quote-based insight arrays remain empty; sampled comments have not been analyzed for repeated questions, pain points or products.",
"Timeframe membership is unknown for 2 threads; apparently recent cached ages do not establish current recency.",
"Some thread scores or total comment counts were unavailable."
],
"sourceUrls": [
"https://www.reddit.com/r/SaaS/comments/example/which_ai_crm_works_for_a_small_sales_team/",
"https://www.reddit.com/r/sales/comments/example2/crm_onboarding_takes_too_long_for_our_team/"
],
"fetchedAt": "2026-07-20T12:00:00.000Z"
},
"ok": true
}
],
"suggestedPrompt": "Cluster these questions by intent and prioritize prompts to track."
}