Registry / messaging / n8n-nodes-socialfetch

n8n-nodes-socialfetch

library0.14.0jsnpmunverified

Community n8n node to fetch real-time social media and web data via the Social Fetch API (v0.14.0). Supports TikTok, Twitter/X, Telegram, Facebook, Instagram, Threads, LinkedIn, Reddit, Spotify, YouTube, and Web scraping. Authentication via API key (sfk_). Includes cursor-based pagination with 'Return All' toggle. Each request costs credits (typically 1). Node descriptions auto-generated from OpenAPI spec. Requires n8n-workflow peer dependency and Node >=22.

messaging ai-ml

npm install n8n-nodes-socialfetch

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · N8N-NODES-SOCIALFE

n8n-nodes-socialfetch

messagingjavascriptv0.14.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SocialFetch

✓ import { SocialFetch } from 'n8n-nodes-socialfetch'

Default export is the node class; used by n8n's node loading mechanism.

SocialFetchApi

✓ import { SocialFetchApi } from 'n8n-nodes-socialfetch'

✗ import { SocialFetchApi } from './SocialFetchApi'

Exported as named export from the package.

type SocialFetchNode

✓ import type { SocialFetch } from 'n8n-nodes-socialfetch'

TypeScript type import for the node class.

Shows how to import the SocialFetch node class and basic usage pattern in an n8n custom workflow.

import { SocialFetch } from 'n8n-nodes-socialfetch' const node = new SocialFetch() console.log(node.description.name) // 'socialFetch' // In a workflow, set credentials (Social Fetch API) with key starting 'sfk_' // Use node with resource 'TikTok', operation 'Profile Videos', handle 'n8n' // Toggle Return All for full cursor-based pagination

Debug

Known issues

gotchaReturn All only works on endpoints that use cursor-based pagination (nextCursor/hasMore). Endpoints using page number or no pagination do not support Return All.

fix

Check the operation's documentation; if it doesn't use cursor, manually pass page parameters under Additional Fields.

affects: >=0.1.0

gotchaEach page from Return All is a separate output item containing the full API response. To merge arrays, use an Item Lists or Code node.

fix

Use n8n's 'Item Lists > Split Out' to extract arrays, then 'Item Lists > Aggregate' or a Code node to combine.

affects: >=0.1.0

deprecatedLegacy credential type 'SocialFetch API' may be deprecated in future in favor of OAuth2 or more secure methods.

fix

Monitor Social Fetch changelog for credential updates.

affects: >=0.1.0 <0.15.0

gotchaAPI key format: 'sfk_' prefix is required. Keys without prefix will fail validation at credential save.

fix

Ensure your API key starts with 'sfk_'.

affects: >=0.1.0

breakingNode >=22 required. Older Node versions will throw engine validation errors during npm install.

fix

Upgrade Node.js to version 22 or later.

affects: >=0.1.0

Errors

Common errors & fixes

ERR_PEER_DEP_MISSING: peer dependency 'n8n-workflow' missing

n8n-workflow is a peer dependency not installed automatically.

fix

Run 'npm install n8n-workflow' in the n8n environment.

Credentials not valid: provided key does not start with 'sfk_'

API key lacks the required 'sfk_' prefix.

fix

Generate a new API key from the Social Fetch dashboard that starts with 'sfk_'.

Operation 'Return All' not available for this resource

The selected endpoint does not support cursor-based pagination.

fix

Disable Return All and use Additional Fields to pass page parameters manually.

Upgrade

Version history

0.14.0latest on npm

Audit

Dependencies

n8n-workflowrequiredpeer dependency required by all n8n community nodes

Agent activity

25 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/social-freak-ltd/n8n-nodes-socialfetch ↗

packagen8n-nodes-socialfetch ↗

homepagehttps://www.socialfetch.dev ↗