# Social Fetch — Pipedream Connect

> Social Media Scraper API for TikTok, Instagram, YouTube & X

- API slug: `social_fetch` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Developer Tools
- Website: https://www.socialfetch.dev
- This page (HTML): https://pipedream.com/apps/social-fetch
- Tools: 25 actions · 1 trigger

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: social_fetch`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "social_fetch",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Get Credit Balance:
const result = await mcp.callTool({
  name: "social_fetch-get-credit-balance",
  arguments: {},
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Social Fetch endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.socialfetch.dev/v1/whoami

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuc29jaWFsZmV0Y2guZGV2L3YxL3dob2FtaQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-get-credit-balance",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    social_fetch: { authProvisionId: "apn_xxxxxxx" },
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (25)

### `social_fetch-get-credit-balance` — Get Credit Balance (Read-only)

Returns the current API credit balance for your Social Fetch account. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-credit-balance.md

### `social_fetch-get-post` — Get Post (Read-only)

Fetches public post, video, or tweet data from a URL. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-post.md

### `social_fetch-get-profile` — Get Profile (Read-only)

Fetches public profile data. Choose platform, then handle or profile URL. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-profile.md

### `social_fetch-get-reddit-post-transcript` — Get Reddit Post Transcript (Read-only)

Get the captions transcript for a Reddit video post. Use this when you need the spoken text of a Reddit-hosted video; for the post's comment thread use List Reddit Post Comments instead. Provide the post URL or a direct hosted video URL, and optionally a two-letter ISO 639-1 language code (e.g. en)…

Full schema: https://pipedream.com/apps/social-fetch/actions/get-reddit-post-transcript.md

### `social_fetch-get-subreddit` — Get Subreddit (Read-only)

Get metadata for a single Reddit community — title, description, subscriber counts, and icon/banner images when available. Use this to look up details about one subreddit; to fetch its posts use List Subreddit Posts instead. Provide the community as a bare name (pics), an r/-prefixed name (r/pics)…

Full schema: https://pipedream.com/apps/social-fetch/actions/get-subreddit.md

### `social_fetch-get-tiktok-trending-feed` — Get TikTok Trending Feed (Read-only)

Fetches the current TikTok trending feed for a given region. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-tiktok-trending-feed.md

### `social_fetch-get-transcript` — Get Transcript (Read-only)

Fetches a transcript for a video or post URL. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-transcript.md

### `social_fetch-get-youtube-trending-shorts` — Get YouTube Trending Shorts (Read-only)

Fetches the current trending YouTube Shorts. No query is required. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/get-youtube-trending-shorts.md

### `social_fetch-list-profile-posts` — List Profile Posts (Read-only)

Lists recent posts, videos, reels, or tweets for a profile. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/list-profile-posts.md

### `social_fetch-list-reddit-post-comments` — List Reddit Post Comments (Read-only)

List the comments and nested replies on a specific Reddit post. Use this after locating a post via List Subreddit Posts when you need its discussion thread. Provide the full post URL (e.g. https://www.reddit.com/r/pics/comments/abc123/title/). Enable Trim for a lighter response shape, and page…

Full schema: https://pipedream.com/apps/social-fetch/actions/list-reddit-post-comments.md

### `social_fetch-list-subreddit-posts` — List Subreddit Posts (Read-only)

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…

Full schema: https://pipedream.com/apps/social-fetch/actions/list-subreddit-posts.md

### `social_fetch-search-instagram-reels` — Search Instagram Reels (Read-only)

Searches Instagram for Reels matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-instagram-reels.md

### `social_fetch-search-linkedin-people` — Search LinkedIn People (Read-only)

Searches LinkedIn for people profiles by first and/or last name. At least one of First Name or Last Name is required. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-linkedin-people.md

### `social_fetch-search-reddit-content` — Search Reddit Content (Read-only)

Searches Reddit for posts matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-reddit-content.md

### `social_fetch-search-reddit-subreddits` — Search Reddit Subreddits (Read-only)

Searches posts within a specific Reddit subreddit. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-reddit-subreddits.md

### `social_fetch-search-threads-content` — Search Threads Content (Read-only)

Searches Threads for posts matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-threads-content.md

### `social_fetch-search-threads-users` — Search Threads Users (Read-only)

Searches Threads for user accounts matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-threads-users.md

### `social_fetch-search-tiktok-content` — Search TikTok Content (Read-only)

Searches TikTok for videos/content matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-tiktok-content.md

### `social_fetch-search-tiktok-hashtags` — Search TikTok Hashtags (Read-only)

Searches TikTok for hashtags matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-tiktok-hashtags.md

### `social_fetch-search-tiktok-shop-products` — Search TikTok Shop Products (Read-only)

Searches TikTok Shop for product listings matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-tiktok-shop-products.md

### `social_fetch-search-tiktok-users` — Search TikTok Users (Read-only)

Searches TikTok for user accounts matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-tiktok-users.md

### `social_fetch-search-twitter-content` — Search Twitter Content (Read-only)

Searches Twitter for posts/tweets matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-twitter-content.md

### `social_fetch-search-twitter-hashtags` — Search Twitter Hashtags (Read-only)

Searches Twitter for hashtag data matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-twitter-hashtags.md

### `social_fetch-search-youtube-content` — Search YouTube Content (Read-only)

Searches YouTube for videos matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-youtube-content.md

### `social_fetch-search-youtube-hashtags` — Search YouTube Hashtags (Read-only)

Searches YouTube for hashtags matching a query. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/actions/search-youtube-hashtags.md

## Triggers (1)

### `social_fetch-new-profile-update` — New Profile Update (Polling)

Emit new event when a monitored profile changes. See the documentation

Full schema: https://pipedream.com/apps/social-fetch/triggers/new-profile-update.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt