n8n-nodes-socialfetch 0.13.2 → 0.13.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +43 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ This is an [n8n](https://n8n.io) community node that lets you fetch real-time so
|
|
|
4
4
|
|
|
5
5
|
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.
|
|
6
6
|
|
|
7
|
-
[Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Development](#development) · [Publishing](PUBLISHING.md)
|
|
7
|
+
[Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Example](#example-workflow) · [Development](#development) · [Publishing](PUBLISHING.md)
|
|
8
8
|
|
|
9
9
|
## Installation
|
|
10
10
|
|
|
@@ -28,6 +28,48 @@ List endpoints that return everything in one response (no cursor), or that pagin
|
|
|
28
28
|
|
|
29
29
|
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`.
|
|
30
30
|
|
|
31
|
+
## Example workflow
|
|
32
|
+
|
|
33
|
+
This example fetches a TikTok creator's recent videos and keeps only the high-performing ones.
|
|
34
|
+
|
|
35
|
+
1. **Manual Trigger** — start the workflow manually for testing.
|
|
36
|
+
2. **SocialFetch** — set **Resource** to `TikTok` and **Operation** to `Profile videos`.
|
|
37
|
+
- **Handle**: `n8n`
|
|
38
|
+
- Turn on **Return All** to page through every video, or leave it off to fetch the first page.
|
|
39
|
+
- Under **Additional Fields**, set **Sort By** to `Popular`.
|
|
40
|
+
3. **Split Out** — field to split out: `data.videos` (one item per video).
|
|
41
|
+
4. **Filter** — keep videos above a view threshold:
|
|
42
|
+
- Condition: `{{ $json.stats.views }}` _is greater than_ `100000`.
|
|
43
|
+
|
|
44
|
+
Each SocialFetch 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.
|
|
45
|
+
|
|
46
|
+
Example response shape (first video on a page):
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{
|
|
50
|
+
"data": {
|
|
51
|
+
"videos": [
|
|
52
|
+
{
|
|
53
|
+
"id": "7639528062975053069",
|
|
54
|
+
"caption": "…",
|
|
55
|
+
"url": "https://www.tiktok.com/@handle/video/7639528062975053069",
|
|
56
|
+
"stats": {
|
|
57
|
+
"views": 302447,
|
|
58
|
+
"likes": 19880,
|
|
59
|
+
"comments": 339,
|
|
60
|
+
"shares": 2232,
|
|
61
|
+
"saves": 389
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
"page": { "nextCursor": "…", "hasMore": true }
|
|
66
|
+
},
|
|
67
|
+
"meta": { "creditsCharged": 1, "requestId": "…", "version": "v1" }
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
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.
|
|
72
|
+
|
|
31
73
|
## Development
|
|
32
74
|
|
|
33
75
|
The node descriptions are generated from the SocialFetch OpenAPI spec.
|