Pipedream
Connect Social Fetch to Pipedream workflows — polling profile updates, consolidated profile/post actions, and credit balance checks with your API key.
Add Social Fetch to Pipedream workflows and pull live social data without writing HTTP glue. Authenticate with your API key (sfk_…); each step returns the same { data, meta } envelope as the REST API.
The v1 integration ships one polling source and five consolidated actions that cover the most common workflow paths — profile lookups, post fetches, feed pagination, transcripts, and balance checks.
What you'll need
- A Pipedream account.
- A Social Fetch API key (starts with
sfk_) — create one in your API Keys dashboard. - Credits for metered routes — see Credits & billing.
Connect your API key
- Open a workflow and add a Social Fetch step (search for Social Fetch in the step picker).
- When prompted, paste your full
sfk_…key from API Keys. - Pipedream validates the connection with
GET /v1/whoamibefore saving.
The same credential is reused across every Social Fetch source and action in your account.
Components (v1)
| Type | Name | Purpose |
|---|---|---|
| Source | New Profile Update | Poll a profile on a schedule; emit when the payload changes |
| Action | Get Profile | Public profile lookup by handle or URL |
| Action | Get Post | Post, video, or tweet lookup from URL |
| Action | List Profile Posts | Recent feed items with optional cursor pagination |
| Action | Get Transcript | Video or post transcript from URL |
| Action | Get Credit Balance | Current API credit balance |
Every action maps to the same routes documented in the API reference.
New Profile Update (source)
The polling source watches one profile and emits when Social Fetch returns a changed payload:
- Choose a Platform and provide a Handle (TikTok, Instagram, Twitter/X, Threads) or Profile URL (Facebook, LinkedIn).
- Pipedream polls on the default timer interval, fetches the profile, and compares the response to the last stored snapshot.
- When a diff is detected, the workflow receives the full API response plus a
diffobject showing what changed.
Use this for creator monitoring, follower-count alerts, or any workflow that should react to profile changes without polling the REST API yourself.
Platform coverage by action
Get Profile — TikTok, Instagram, Twitter/X, Threads (handle), Facebook and LinkedIn (profile URL).
Get Post — TikTok, Instagram, Twitter/X, Threads, Facebook, YouTube, LinkedIn (post URL).
List Profile Posts — TikTok (videos), Instagram (posts or reels), Twitter/X (tweets), Threads and Facebook (posts). Pass data.page.nextCursor from a previous response to fetch the next page.
Get Transcript — TikTok, Instagram, Facebook, YouTube (media URL).
Get Credit Balance — account-wide; no platform input required.
Credits
Each step consumes credits from your Social Fetch balance. The amount charged is returned in meta.creditsCharged on every response. See Credits & billing for metered routes and 402 handling.
Full API surface
Pipedream v1 intentionally covers high-traffic workflow paths. For every documented route — Reddit, Spotify, web scrape, and more — use the REST API, TypeScript SDK, n8n node, or Apify Store Actors for TikTok-only Apify-native runs.
Next steps
API reference
Browse every endpoint behind the Pipedream actions — params, examples, and response shapes.
n8n
Full platform coverage in no-code workflows with the same API key.
MCP
OAuth-connected tools for Cursor, VS Code, and Claude.
Credits & billing
Understand metered routes, 402 handling, and creditsCharged metadata.