n8n-nodes-socialfetch 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Social Freak Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# n8n-nodes-socialfetch
+
+This is an [n8n](https://n8n.io) community node that lets you fetch real-time social media and web data using the [SocialFetch API](https://www.socialfetch.dev).
+
+It exposes a single **SocialFetch** node with one resource per platform (TikTok, Twitter/X, Telegram, Facebook, Instagram, Threads, LinkedIn, Reddit, Spotify, YouTube, Web) plus account operations under **Account** (Whoami, Balance). Each operation maps directly to a SocialFetch public API endpoint.
+
+[Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Development](#development) · [Publishing](PUBLISHING.md)
+
+## Installation
+
+Follow the [community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) and install the npm package `n8n-nodes-socialfetch`.
+
+## Credentials
+
+You need a SocialFetch API key (it starts with `sfk_`). Create one in your [SocialFetch dashboard](https://www.socialfetch.dev).
+
+In n8n, create a new **SocialFetch API** credential and paste your key. The credential is validated against `GET /v1/whoami` when you save it.
+
+## Operations
+
+Pick a **Resource** (platform) and an **Operation**. Required inputs appear as direct fields; optional inputs live under **Additional Fields**.
+
+### Pagination and “Return All”
+
+Only list endpoints that use SocialFetch’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**.
+
+Every request consumes credits from your SocialFetch 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`.
+
+## Development
+
+```bash
+pnpm install
+pnpm run lint:fix
+pnpm run build
+pnpm run dev   # local n8n at http://localhost:5678 with this node loaded
+```
+
+Source of truth for API coverage lives in the [SocialFetch](https://github.com/social-freak-ltd/socialfetch) monorepo (`integrations/n8n/`). Sync generated description files from there when the public API changes.
+
+## License
+
+[MIT](./LICENSE)

package/dist/credentials/SocialFetchApi.credentials.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialFetchApi = void 0;
+class SocialFetchApi {
+    constructor() {
+        this.name = "socialFetchApi";
+        this.displayName = "SocialFetch API";
+        this.documentationUrl = "https://www.socialfetch.dev/docs";
+        this.icon = "file:socialfetch.svg";
+        this.properties = [
+            {
+                displayName: "API Key",
+                name: "apiKey",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                required: true,
+                description: "Your SocialFetch API key (starts with sfk_). Create one in the SocialFetch dashboard.",
+            },
+        ];
+        this.authenticate = {
+            type: "generic",
+            properties: {
+                headers: {
+                    "x-api-key": "={{$credentials.apiKey}}",
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: "https://api.socialfetch.dev",
+                url: "/v1/whoami",
+            },
+        };
+    }
+}
+exports.SocialFetchApi = SocialFetchApi;

package/dist/credentials/socialfetch.svg

@@ -0,0 +1,29 @@
+<svg
+  width="48"
+  height="48"
+  viewBox="0 0 48 48"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+>
+  <rect width="48" height="48" fill="#AAF7ED" />
+  <g clip-path="url(#clip0_200_7)">
+    <path
+      d="M25.5245 32.8171H19.6903V38.6513H25.5245L31.3586 32.8171L37.1928 26.983L40.1099 24.0659L37.1928 21.1488L31.3586 15.3146L25.5245 9.48047H19.6903V15.3146H25.5245V21.1488H31.3586V26.983H25.5245V32.8171Z"
+      fill="#232023"
+    />
+    <path
+      d="M19.6903 32.8171V26.983H25.5245V21.1488H19.6903V15.3146H13.8561V21.1488V26.983V32.8171H19.6903Z"
+      fill="#232023"
+    />
+  </g>
+  <defs>
+    <clipPath id="clip0_200_7">
+      <rect
+        width="32.0879"
+        height="32.0879"
+        fill="white"
+        transform="translate(8.02197 8.02197)"
+      />
+    </clipPath>
+  </defs>
+</svg>

package/dist/nodes/SocialFetch/SocialFetch.node.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialFetch = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const index_generated_1 = require("./descriptions/index.generated");
+class SocialFetch {
+    constructor() {
+        this.description = {
+            displayName: "SocialFetch",
+            name: "socialFetch",
+            icon: "file:socialfetch.svg",
+            group: ["input"],
+            version: 1,
+            subtitle: '={{$parameter["operation"].replace(/\\./g, " › ").replace(/^[^›]+ › /, "")}}',
+            description: "Fetch social media and web data via the SocialFetch API",
+            defaults: { name: "SocialFetch" },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: "socialFetchApi", required: true }],
+            requestDefaults: {
+                baseURL: "https://api.socialfetch.dev",
+                headers: {
+                    Accept: "application/json",
+                },
+            },
+            properties: [
+                {
+                    displayName: "Resource",
+                    name: "resource",
+                    type: "options",
+                    noDataExpression: true,
+                    options: index_generated_1.resourceOptions,
+                    default: "tiktok",
+                },
+                ...index_generated_1.allResourceProperties,
+            ],
+            usableAsTool: true,
+        };
+    }
+}
+exports.SocialFetch = SocialFetch;

package/dist/nodes/SocialFetch/descriptions/auth.generated.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auth = void 0;
+exports.auth = [
+    {
+        "displayName": "Operation",
+        "name": "operation",
+        "type": "options",
+        "noDataExpression": true,
+        "displayOptions": {
+            "show": {
+                "resource": [
+                    "auth"
+                ]
+            }
+        },
+        "default": "auth.whoami",
+        "options": [
+            {
+                "name": "Whoami",
+                "value": "auth.whoami",
+                "action": "Whoami",
+                "description": "Get the authenticated API account.",
+                "routing": {
+                    "request": {
+                        "method": "GET",
+                        "url": "/v1/whoami"
+                    }
+                }
+            },
+            {
+                "name": "Balance",
+                "value": "billing.balance.get",
+                "action": "Get account balance",
+                "description": "Get your account credit balance.",
+                "routing": {
+                    "request": {
+                        "method": "GET",
+                        "url": "/v1/balance"
+                    }
+                }
+            }
+        ]
+    }
+];