View as Markdown
Social Fetch icon

Social Fetch ACTION

List Subreddit Posts

List posts from a single subreddit, with optional sorting (best, hot, new, top, rising) and a timeframe for time-based sorts (all, day, week, month, year). Use this to browse or page through a community's feed; for details about the community itself use Get Subreddit, and to read a specific post's replies use List Reddit Post Comments. Accepts the subreddit as a bare name (pics), an r/-prefixed name (r/pics), or a subreddit URL. Page through results with the cursor. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Social Fetch account once, then configure and run List Subreddit Posts from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "social_fetch-list-subreddit-posts",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    social_fetch: { authProvisionId: "apn_xxxxxxx" },
    subreddit: "Subreddit",
    sort: "Sort",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Subreddit Posts inputs
Property Type Description
subreddit Subreddit string
Subreddit name, optional r/ prefix, or Reddit subreddit URL (string). Must match Reddit's exact casing. E.g. pics, r/pics, or https://www.reddit.com/r/pics.
Required
sort Sort string
Sort order for the returned posts (string). One of: best, hot, new, top, rising.
Optional
timeframe Timeframe string
Timeframe used with time-based sort orders such as top (string). One of: all, day, week, month, year.
Optional
cursor Cursor string
Pagination cursor from a previous response (data.page.nextCursor).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
social_fetch-list-subreddit-posts
Version
0.0.3
App
Social Fetch
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes