Api Endpoint

SocialFetch

Search posts within one subreddit (not site-wide — use reddit.search.list for that).

Open interactive test console

Offering

Provider: api.socialfetch.dev
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Social Intelligence
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://api.socialfetch.dev/v1/reddit/subreddits/search
MIME type: application/json
First seen: 2026-10-16T01:50:53.972Z
Last seen: 2026-11-02T14:45:43.098Z
Tags: Reddit, social-data

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.014 USDC
Atomic price: 14000 · Network: eip155:8453 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "14000",
    "payTo": "0x02C2fCAfCe36B4AAdB39625866Bc6B1699d83043"
  }
]

Observed health

Status: Healthy
Latest latency: 35 ms
Average latency: 208 ms
HTTP status: 402
Last checked: 2026-11-02T14:45:43.092Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "subreddit": {
          "description": "Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Searches posts within this subreddit.",
          "type": "string",
          "minLength": 1,
          "maxLength": 256
        },
        "query": {
          "description": "Search text to match against public subreddit posts.",
          "type": "string",
          "minLength": 1,
          "maxLength": 512
        },
        "sort": {
          "type": "string",
          "enum": [
            "relevance",
            "hot",
            "top",
            "new",
            "comments"
          ],
          "description": "Sort order for search results. Default: `relevance`."
        },
        "timeframe": {
          "type": "string",
          "enum": [
            "all",
            "year",
            "month",
            "week",
            "day",
            "hour"
          ],
          "description": "Time range filter for search results. Default: `all`."
        },
        "cursor": {
          "description": "Opaque pagination cursor returned by a previous response.",
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "subreddit"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "cursor": {
              "description": "Opaque pagination cursor returned by a previous response.",
              "minLength": 1,
              "type": "string"
            },
            "query": {
              "description": "Search text to match against public subreddit posts.",
              "maxLength": 512,
              "minLength": 1,
              "type": "string"
            },
            "sort": {
              "description": "Sort order for search results. Default: `relevance`.",
              "enum": [
                "relevance",
                "hot",
                "top",
                "new",
                "comments"
              ],
              "type": "string"
            },
            "subreddit": {
              "description": "Subreddit name, optional `r/` prefix, or Reddit subreddit URL. Must match Reddit's exact casing. Searches posts within this subreddit.",
              "maxLength": 256,
              "minLength": 1,
              "type": "string"
            },
            "timeframe": {
              "description": "Time range filter for search results. Default: `all`.",
              "enum": [
                "all",
                "year",
                "month",
                "week",
                "day",
                "hour"
              ],
              "type": "string"
            }
          },
          "required": [
            "subreddit"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}