n8n

Add Social Fetch to n8n and every platform we support becomes a drag-and-drop step: pull profiles, posts, and metrics into a workflow, or attach the node to an AI agent as a live data tool. Each operation maps 1:1 to a public API endpoint, so anything in the API reference works as a no-code step — via the n8n-nodes-socialfetch community node.

What you'll need

• An n8n instance — n8n Cloud, or self-hosted with community nodes enabled.
• A Social Fetch API key (starts with sfk_) — create one in your API Keys dashboard.
• Credits on your account for metered routes — see Credits & billing.

Install

Follow n8n's community nodes installation guide and install the package n8n-nodes-socialfetch.

1. Open your n8n instance and go to Settings.
2. Select Community nodes.
3. Click Install.
4. Enter the package name: n8n-nodes-socialfetch
5. Read the risk acknowledgement, tick the checkbox, and click Install.

After installation, the Social Fetch node appears in the node picker when you add a step to a workflow.

Credentials

You need a Social Fetch API key (it starts with sfk_). Create one in your API Keys dashboard.

In n8n:

1. Go to Credentials and click Add credential.
2. Search for Social Fetch API.
3. Paste your API key and save.

The credential is validated against GET /v1/whoami when you save it — if the key is invalid, n8n will show an error immediately.

Using the node

Add a Social Fetch node to your workflow and configure:

1. Credential — select your Social Fetch API credential.
2. Resource — pick the platform (e.g. TikTok, Instagram, Web) or Account for whoami/balance.
3. Operation — choose the endpoint (e.g. Profile videos, Search, Markdown).
4. Required fields — shown as direct inputs on the node.
5. Additional Fields — optional query parameters (sort order, limits, etc.).

The node is marked usable as tool, so you can also attach it to n8n AI agents that need live social or web data.

Pagination and Return All

Only list endpoints that use Social Fetch's cursor query parameter show a Return All toggle. When enabled, the node follows data.page.nextCursor until data.page.hasMore is false. Each page is a separate output item containing the full API JSON body (data, meta, etc.). Use n8n's Item Lists or Code node if you need a single merged array.

List endpoints that return everything in one response (no cursor), or that paginate with other parameters such as page, do not show Return All — you get the first response only unless you pass those parameters under Additional Fields.

Credits

Every request consumes credits from your Social Fetch balance (most endpoints cost 1 credit; some search and media-download options cost more). The credits charged for each call are returned in meta.creditsCharged. See Credits & billing for details.

Example workflow

This example fetches a TikTok creator's recent videos and keeps only the high-performing ones.

1. Manual Trigger — start the workflow manually for testing.
2. Social Fetch — set Resource to TikTok and Operation to Profile videos.
   • Handle: n8n
   • Turn on Return All to page through every video, or leave it off to fetch the first page.
   • Under Additional Fields, set Sort By to Popular.
3. Split Out — field to split out: data.videos (one item per video).
4. Filter — keep videos above a view threshold:
   • Condition: {{ $json.stats.views }} is greater than 100000.

Each Social Fetch item is one API page. With Return All off you get a single page; with it on you get one item per page, each containing data.videos, data.page, and meta. Split Out turns the videos array into individual items so the Filter node can evaluate stats.views on each video.

Example response shape (first video on a page):

{
  "data": {
    "videos": [
      {
        "id": "7639528062975053069",
        "caption": "…",
        "url": "https://www.tiktok.com/@handle/video/7639528062975053069",
        "stats": {
          "views": 302447,
          "likes": 19880,
          "comments": 339,
          "shares": 2232,
          "saves": 389
        }
      }
    ],
    "page": { "nextCursor": "…", "hasMore": true }
  },
  "meta": { "creditsCharged": 1, "requestId": "…", "version": "v1" }
}

Enrichment pattern

A second common pattern is enrichment: use TikTok → User search (or Search videos) to discover handles, then loop those results back into Profile videos or Profile to pull full details for each match.

Next steps