n8n

You can call SocialCrawl from any n8n workflow today using the built-in HTTP Request node: one GET request with your key in the x-api-key header returns structured data from any of 42 platforms. A dedicated SocialCrawl community node is built and coming to the n8n registry, which will turn every endpoint into a point-and-click operation.

How do I use SocialCrawl in n8n right now?

Add an HTTP Request node and configure it:

• Method: GET
• URL: https://www.socialcrawl.dev/v1/tiktok/profile (swap in any platform and resource)
• Query parameters: the endpoint's inputs, for example handle = charlidamelio
• Headers: x-api-key = your key (store it in an n8n credential, not inline)

The node returns the full SocialCrawl envelope, so the downstream nodes can read data, credits_used, and credits_remaining directly:

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "author": { "username": "charlidamelio", "followers": 155000000 },
    "computed": { "engagement_rate": 0.082, "language": "en" }
  },
  "credits_used": 1,
  "credits_remaining": 99,
  "request_id": "req-abc123",
  "cached": false
}

Because every platform returns the same envelope, one HTTP Request node handles TikTok, Instagram, YouTube, LinkedIn, Amazon, and the rest, only the URL and query parameters change. To validate your key without spending anything, point the node at GET /v1/credits/balance, which is always free.

How do I store my API key securely in n8n?

Create a Header Auth credential: set the header name to x-api-key and the value to your key (it looks like sc_...). Attach that credential to the HTTP Request node so the key never appears in the workflow JSON or execution logs. Get a key at socialcrawl.dev under Dashboard → API Keys; new accounts start with 100 free credits.

Is there a dedicated SocialCrawl node?

Yes, and it is built. n8n-nodes-socialcrawl exposes one Resource per platform and one Operation per endpoint, generated directly from the live API registry so it always mirrors the current surface. It is usableAsTool, so an n8n AI Agent can call any SocialCrawl endpoint as a tool.

It is not yet listed in the n8n community registry. Once it publishes, installation will be a two-click step:

1. In n8n, open Settings → Community Nodes and select Install (an instance owner has to enable community nodes first; verified install needs n8n v1.94.0+).
2. Enter the package name n8n-nodes-socialcrawl and install.

After that, add the SocialCrawl node, pick a Resource (a platform, or Universal Search), pick an Operation (an endpoint), and fill in the fields. Until it lands in the registry, the HTTP Request approach above is the supported path and covers every endpoint.

What does it cost?

Whether you call the API through the HTTP Request node or the dedicated node, credits are billed identically: standard endpoints are 1 credit, transcripts and other premium endpoints are 10 credits, and the universal search/everywhere call is a flat 20 credits. Empty results and upstream errors are auto-refunded, and cache hits cost 0 credits. See Credits and Endpoint pricing, or Pricing for credit packs.

Where to go next

• Browse the platform directory to find the exact /v1/{platform}/{resource} path for your workflow.
• Universal search fans one query across 12 platforms in a single request, ideal for a scheduled listening workflow.
• New to the API? Start with the Quickstart and Authentication.
• Building an agent instead of a workflow? See Claude Code, LangChain, and Vercel AI SDK.