> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). For curated orientation and workflow guidance, start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for agent onboarding and crawl rules, use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for the full endpoint list with links to pages like this one, use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt); for one platform's parameters and curls, use [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need structured JSON for tool registration. ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** ## API base URL and authentication - **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev` - **Authentication:** send `x-api-key: sfk_...` on `/v1/**` and `/v2/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route). - **OpenAPI JSON:** ## Recommended docs entrypoints (this site) - [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown). - [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope. - [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`. - [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — every operation with identifiers, pagination, outcomes, media download, credits, and its SDK method. Generated from OpenAPI, so use it for route selection instead of scanning individual pages. - [Recipes](https://www.socialfetch.dev/docs/recipes.mdx) — copyable workflows (brand monitoring, transcripts, Ad Library, creator scoring, Reddit research) with credit callouts and SDK examples. - [Integrations](https://www.socialfetch.dev/docs/integrations.mdx) — MCP for AI clients, n8n verified node, Apify Store Actors, Make custom app, SDK, and REST API connection paths. - [MCP product page](https://www.socialfetch.dev/mcp) — hosted MCP overview, OAuth, Skills install. - [MCP integration](https://www.socialfetch.dev/docs/integrations/mcp.mdx) — hosted `/mcp` server, OAuth, Cursor/VS Code/Claude install snippets, 264 endpoint tools, plus docs_search/docs_read for implementation help. - [n8n integration](https://www.socialfetch.dev/docs/integrations/n8n.mdx) — install `n8n-nodes-socialfetch`, credentials, and workflow examples. - [Apify integration](https://www.socialfetch.dev/docs/integrations/apify.mdx) — Store Actors under @social-fetch, PPE billing, dataset export, and quick start. - [Make integration](https://www.socialfetch.dev/docs/integrations/make.mdx) — custom app modules for Make scenarios, API key credentials, and module catalog. - [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt) — every documented operation with a direct link to that route's agent-readable markdown page (prefer this over parsing OpenAPI). - [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt) — per-platform endpoint files generated from OpenAPI (parameters, credits, curls). - [`/agents.txt`](https://www.socialfetch.dev/agents.txt) — agent crawl/onboarding file with capabilities, auth rules, and allowlist. - [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping. - [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages. - [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance. - [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs. - Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract. ## Markdown docs convention - Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`). - Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`). - Published blog posts use the same convention: `/blog/{slug}` → `/blog/{slug}.mdx`, or `Accept: text/markdown` on the HTML URL (`Vary: Accept`). --- # n8n workflow templates for Social Fetch (https://www.socialfetch.dev/docs/integrations/n8n/templates) Each template is a working n8n workflow. Import it, connect your accounts, change the handle and run it. Every template opens with a **Start here** note on the canvas that lists what to set up. ## How to import a template 1. Copy the template's link below. 2. In n8n, create a new workflow, open the **⋯** menu next to its name and choose **Import → From URL**. 3. Paste the link and click **Import**. You can also download the file and use **Import → From file**, or open the link, copy everything and paste it onto an empty canvas. After importing, n8n marks the nodes that still need an account. Open each one, pick or create the credential, and the warning goes away. Templates use the newest Social Fetch node, so [update the node](/docs/integrations/n8n/troubleshooting#update-the-node) first if n8n says it doesn't recognise it. ## TikTok videos to Google Sheets Every morning, add a creator's latest TikTok videos to a Google Sheet, and update the views and likes of videos already there. It runs a Schedule Trigger, then Social Fetch (List TikTok profile videos), then Google Sheets (Append or Update Row). You'll need a Google Sheet with the headers Posted, Caption, Views, Likes and URL. ```text https://www.socialfetch.dev/integrations/n8n/workflows/tiktok-videos-to-google-sheets.json ``` The [first workflow tutorial](/docs/integrations/n8n/first-workflow) builds this one step by step. ## New posts to Slack Post a message in Slack whenever an account has a new post. It uses the [Social Fetch Trigger](/docs/integrations/n8n/watch-for-new-posts) (TikTok: New videos from a profile) and a Slack node, so it only runs when there's something new. It needs n8n Cloud, or a self-hosted n8n with a public https address on port 443. ```text https://www.socialfetch.dev/integrations/n8n/workflows/new-posts-to-slack.json ``` To watch Instagram, YouTube, X, LinkedIn or Reddit instead, change the trigger's **Watch** field. ## New posts to Slack (any n8n) The same result without the trigger, for an n8n that isn't reachable from the internet, like one on your own computer. A Schedule Trigger runs Social Fetch (List TikTok profile videos), and n8n's Remove Duplicates node drops the videos the workflow has already seen before the Slack node. ```text https://www.socialfetch.dev/integrations/n8n/workflows/new-posts-to-slack-scheduled.json ``` Before you publish it, run it once with the Slack node turned off, as the Start here note explains, so the videos already up aren't all sent at once. ## Enrich a list of creators Read TikTok usernames from a Google Sheet, look up each profile with Social Fetch (Get TikTok profile), and write followers, likes, video count and bio back to the same row. You'll need a Google Sheet with the headers handle, followers, likes, videos and bio, with usernames in the handle column. ```text https://www.socialfetch.dev/integrations/n8n/workflows/enrich-creator-list.json ``` Each row is one request. Try it on a few rows first; see [Running the node for every row of a list](/docs/integrations/n8n/results#running-the-node-for-every-row-of-a-list). ## AI research agent Chat with an agent that looks up TikTok and Instagram profiles and YouTube channel videos as it answers. It has a Chat Trigger, an AI Agent with an OpenAI chat model (swap in another model if you prefer), and three Social Fetch tools. ```text https://www.socialfetch.dev/integrations/n8n/workflows/ai-social-research-agent.json ``` Click **Open chat** and ask, for example, *How many followers does @nasa have on TikTok and Instagram?* See [Use with the AI Agent](/docs/integrations/n8n/ai-agent) to add more tools. ## Next steps - [Your first workflow](/docs/integrations/n8n/first-workflow) — Build the Google Sheets template step by step. - [Watch for new posts](/docs/integrations/n8n/watch-for-new-posts) — How the Social Fetch Trigger works. - [Troubleshooting](/docs/integrations/n8n/troubleshooting) — Imports, credentials and errors.