{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cite42-dev/json-schema/cite42-dev-post-api-v1-reddit-trends-response-schema.json",
  "title": "PostApiV1RedditTrendsResponse",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/cite42-dev-openapi-generated.yml#/components/schemas/PostApiV1RedditTrendsResponse",
  "type": "object",
  "properties": {
    "topic": {
      "type": "string"
    },
    "timeframe": {
      "type": "string"
    },
    "provider": {
      "type": "string"
    },
    "subredditsSearched": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "relevantThreads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "subreddit": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "permalink": {
            "type": "string"
          },
          "score": {
            "type": [
              "string",
              "null"
            ]
          },
          "comments": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "dateSource": {
            "type": "string"
          },
          "textSource": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "ageText": {
            "type": "string"
          },
          "withinTimeframe": {
            "type": [
              "string",
              "null"
            ]
          },
          "sampledComments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {
                  "type": "string"
                },
                "ageText": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              }
            }
          },
          "summary": {
            "type": "string"
          },
          "citationUrl": {
            "type": "string"
          },
          "titleSource": {
            "type": "string"
          }
        }
      }
    },
    "risingThreads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "subreddit": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "permalink": {
            "type": "string"
          },
          "score": {
            "type": [
              "string",
              "null"
            ]
          },
          "comments": {
            "type": [
              "string",
              "null"
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "dateSource": {
            "type": "string"
          },
          "textSource": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "ageText": {
            "type": "string"
          },
          "withinTimeframe": {
            "type": [
              "string",
              "null"
            ]
          },
          "sampledComments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {
                  "type": "string"
                },
                "ageText": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              }
            }
          },
          "summary": {
            "type": "string"
          },
          "citationUrl": {
            "type": "string"
          },
          "titleSource": {
            "type": "string"
          }
        }
      }
    },
    "repeatedQuestions": {
      "type": "array",
      "items": {}
    },
    "painPoints": {
      "type": "array",
      "items": {}
    },
    "repeatedPhrases": {
      "type": "array",
      "items": {}
    },
    "mentionedProducts": {
      "type": "array",
      "items": {}
    },
    "analysis": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string"
        },
        "candidateCount": {
          "type": "integer"
        },
        "relevantCount": {
          "type": "integer"
        },
        "evidenceType": {
          "type": "string"
        }
      }
    },
    "subredditBreakdown": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "subreddit": {
            "type": "string"
          },
          "posts": {
            "type": "integer"
          },
          "totalScore": {
            "type": [
              "string",
              "null"
            ]
          },
          "totalComments": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "collection": {
      "type": "object",
      "properties": {
        "gemini": {
          "type": "string"
        },
        "dataforseo": {
          "type": "string"
        },
        "rss": {
          "type": "string"
        }
      }
    },
    "coverage": {
      "type": "object",
      "properties": {
        "threadsFound": {
          "type": "integer"
        },
        "pagesAttempted": {
          "type": "integer"
        },
        "pagesRead": {
          "type": "integer"
        },
        "threadsWithAge": {
          "type": "integer"
        },
        "threadsWithinTimeframe": {
          "type": "integer"
        },
        "threadsOutsideTimeframe": {
          "type": "integer"
        },
        "threadsWithUnknownTimeframe": {
          "type": "integer"
        },
        "threadsWithScore": {
          "type": "integer"
        },
        "threadsWithCommentCount": {
          "type": "integer"
        },
        "commentsRetrieved": {
          "type": "integer"
        },
        "readingStatus": {
          "type": "string"
        }
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sourceUrls": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fetchedAt": {
      "type": "string",
      "format": "date-time"
    },
    "requestId": {
      "type": "string"
    },
    "billing": {
      "type": "object",
      "properties": {
        "cost": {
          "type": "object",
          "properties": {
            "microCredits": {
              "type": "integer"
            },
            "usd": {
              "type": "string"
            }
          }
        },
        "balance": {
          "type": "object",
          "properties": {
            "microCredits": {
              "type": "integer"
            },
            "usd": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}