Reddit Trends API endpoint

POST /v1/reddit/trendsAbout Reddit Trends

Find public Reddit discussions with cited summaries, Gemini-read post text, sampled comments, relative ages and available engagement metrics.

Overview

Finds relevant threads through Google Search and reads up to three pages through Gemini URL context. Read pages include titles, authors, opening post text, relative ages, available scores and comment counts, and up to five sampled human comments. Summaries remain model paraphrases; page extraction may use cached content and is not independently verified.

Use relevantThreads and check coverage and warnings. Unread pages keep their summaries and URL-slug titles. Exact dates and growth are unavailable; quote-based insight arrays stay empty. withinTimeframe is false for clearly old threads and null when recency is unknown, including apparently recent cached ages.sampledComments is a sample, not a ranking or complete conversation.risingThreads is a deprecated alias. Each request costs $0.20.

Reference

POST/v1/reddit/trends

$0.20 · flat per call

Parameters

topicstringrequired

Topic, category, product, or audience to research on Reddit.

subredditsstring[]optional

Optional subreddit names to focus on, without the r/ prefix.

timeframestringoptional

Conversation window, e.g. "past_7_days", "past_30_days", "past_90_days". Default: "past_30_days".

Parameter	Type	Description
topicrequired	string	Topic, category, product, or audience to research on Reddit.
subredditsoptional	string[]	Optional subreddit names to focus on, without the r/ prefix.
timeframeoptional	string	Conversation window, e.g. "past_7_days", "past_30_days", "past_90_days". Default: "past_30_days".

Request

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

Response

{
  "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",
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 20000,
      "usd": "0.20"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}