@adaptive-ds/n8n-nodes-publer 1.1.6 → 1.1.8

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.
Files changed (3) hide show
  1. package/dist/nodes/Publer/openapi.json +554 -171
  2. package/dist/package.json +1 -1
  3. package/package.json +1 -1
package/dist/nodes/Publer/openapi.json CHANGED
@@ -2,25 +2,17 @@
2
2
  "openapi": "3.0.0",
3
3
  "info": {
4
4
  "title": "Publer API",
5
- "description": "Welcome to the **Publer API** collection!\n\nThis API enables developers, agencies, and marketing teams to automate social media workflows, integrate advanced scheduling tools, and manage multiple brands at scale—all from your own applications.\n\n---\n\n## What is the Publer API?\n\nThe Publer API is a modern, RESTful JSON interface designed for seamless social media automation. It lets you programmatically access and manage all core functions of the Publer platform, including:\n\n- **Publishing & Scheduling** \n Draft, schedule, auto-schedule, or instantly publish posts (including bulk and recurring content) across 13+ supported social platforms.\n \n- **Media Management** \n Upload, organize, and attach media—images, videos, GIFs, PDFs, and more. Apply watermarks and manage media libraries per workspace or account.\n \n- **Workspace & Collaboration** \n Manage teams, clients, and brands through isolated workspaces. Retrieve user profiles, permissions, and organize content by workspace.\n \n- **Advanced Features** \n Automate post actions (auto-share, follow-up comments, auto-delete), append branded signatures, use location tags, and customize posts with platform-specific features.\n \n\n---\n\n## Supported Social Networks\n\nPublish and manage content on:\n\n- Facebook, Instagram, Twitter/X, LinkedIn, Pinterest, YouTube, TikTok, Google Business Profile, WordPress, Telegram, Mastodon, Threads, and Bluesky.\n \n\n---\n\n## Core Capabilities\n\n- **Content Types:** \n Status updates, images, videos, reels, stories, polls, PDFs, links, carousels, events, offers, and more.\n \n- **Bulk Scheduling:** \n Schedule up to 500 posts in a single request for efficient multi-account planning.\n \n- **Media Options:** \n Organize Facebook albums, Pinterest boards, and apply account-specific watermarks.\n \n- **Branding & Protection:** \n Use signatures and watermarks to reinforce your brand and protect creative assets.\n \n\n---\n\n## How to Get Started\n\n1. **Generate an API Key**\n \n - Sign in with Ambassador or Enterprise access.\n \n - Go to `Settings → Access & Login → API Keys`, generate a key, and copy it securely.\n \n2. **List Your Workspaces & Accounts**\n \n - Use the API to retrieve workspace and account IDs for all actions.\n \n3. **Upload Media (Optional)**\n \n - Upload images, videos, or docs to get reusable media IDs.\n \n4. **Create & Schedule Posts**\n \n - Use the Posts API to draft, schedule, or bulk publish content across your accounts.\n \n5. **Monitor Jobs**\n \n - Every action returns a job ID—track and analyze your posts programmatically.\n \n\n---\n\n## Best Practices\n\n- Store and manage API keys securely.\n \n- Use the minimum scopes required for your integrations.\n \n- Comply with posting limits and content guidelines for each platform.\n \n- Use `alt_text` for accessible images.\n \n\n---\n\n## Documentation & Support\n\n- For full endpoint details, examples, and best practices, refer to the [Publer API Documentation](https://publer.com/docs).\n \n\n---\n\n**Build smarter. Automate faster. Take control of your social content with the Publer API!**",
5
+ "description": "Welcome to the **Publer API** collection!\n\nThis API enables developers, agencies, and marketing teams to automate social media workflows, integrate advanced scheduling tools, and manage multiple brands at scale—all from your own applications.\n\n---\n\n## What is the Publer API?\n\nThe Publer API is a modern, RESTful JSON interface designed for seamless social media automation. It lets you programmatically access and manage all core functions of the Publer platform, including:\n\n- **Publishing & Scheduling** \n Draft, schedule, auto-schedule, or instantly publish posts (including bulk and recurring content) across 13+ supported social platforms.\n \n- **Media Management** \n Upload, organize, and attach media—images, videos, GIFs, PDFs, and more. Apply watermarks and manage media libraries per workspace or account.\n \n- **Workspace & Collaboration** \n Manage teams, clients, and brands through isolated workspaces. Retrieve user profiles, permissions, and organize content by workspace.\n \n- **Advanced Features** \n Automate post actions (auto-share, follow-up comments, auto-delete), append branded signatures, use location tags, and customize posts with platform-specific features.\n \n\n---\n\n## Supported Social Networks\n\nPublish and manage content on:\n\n- Facebook, Instagram, Twitter/X, LinkedIn, Pinterest, YouTube, TikTok, Google Business Profile, WordPress, Telegram, Mastodon, Threads, and Bluesky.\n \n\n---\n\n## Core Capabilities\n\n- **Content Types:** \n Status updates, images, videos, reels, stories, polls, PDFs, links, carousels, events, offers, and more.\n \n- **Bulk Scheduling:** \n Schedule up to 500 posts in a single request for efficient multi-account planning.\n \n- **Media Options:** \n Organize Facebook albums, Pinterest boards, and apply account-specific watermarks.\n \n- **Branding & Protection:** \n Use signatures and watermarks to reinforce your brand and protect ...\n",
6
6
  "version": "1.0.0"
7
7
  },
8
8
  "servers": [
9
9
  {
10
- "url": "http://{{url}}"
10
+ "url": "https://app.publer.com/api/v1"
11
11
  }
12
12
  ],
13
- "components": {
14
- "securitySchemes": {
15
- "apikeyAuth": {
16
- "type": "http",
17
- "scheme": "apikey"
18
- }
19
- }
20
- },
21
13
  "security": [
22
14
  {
23
- "apikeyAuth": []
15
+ "bearerAuth": []
24
16
  }
25
17
  ],
26
18
  "tags": [
@@ -65,12 +57,12 @@
65
57
  }
66
58
  ],
67
59
  "paths": {
68
- "/api/v1/users/me": {
60
+ "/users/me": {
69
61
  "get": {
70
62
  "tags": [
71
63
  "USERS"
72
64
  ],
73
- "summary": "ME",
65
+ "summary": "Me",
74
66
  "responses": {
75
67
  "200": {
76
68
  "description": "Successful response",
@@ -81,12 +73,12 @@
81
73
  }
82
74
  }
83
75
  },
84
- "/api/v1/workspaces": {
76
+ "/workspaces": {
85
77
  "get": {
86
78
  "tags": [
87
79
  "WORKSPACES"
88
80
  ],
89
- "summary": "FETCH WORKSPACES",
81
+ "summary": "Fetch workspaces",
90
82
  "responses": {
91
83
  "200": {
92
84
  "description": "Successful response",
@@ -97,12 +89,12 @@
97
89
  }
98
90
  }
99
91
  },
100
- "/api/v1/workspaces/{workspace_id}/signatures": {
92
+ "/workspaces/{workspace_id}/signatures": {
101
93
  "get": {
102
94
  "tags": [
103
95
  "WORKSPACES"
104
96
  ],
105
- "summary": "FETCH SIGNATURES",
97
+ "summary": "Fetch signatures",
106
98
  "parameters": [
107
99
  {
108
100
  "name": "accounts[]",
@@ -131,12 +123,12 @@
131
123
  }
132
124
  }
133
125
  },
134
- "/api/v1/workspaces/{workspace_id}/media_options": {
126
+ "/workspaces/{workspace_id}/media_options": {
135
127
  "get": {
136
128
  "tags": [
137
129
  "WORKSPACES"
138
130
  ],
139
- "summary": "FETCH MEDIA OPTIONS",
131
+ "summary": "Fetch media options",
140
132
  "parameters": [
141
133
  {
142
134
  "name": "accounts[]",
@@ -165,12 +157,12 @@
165
157
  }
166
158
  }
167
159
  },
168
- "/api/v1/accounts": {
160
+ "/accounts": {
169
161
  "get": {
170
162
  "tags": [
171
163
  "ACCOUNTS"
172
164
  ],
173
- "summary": "ACCOUNTS",
165
+ "summary": "List Accounts",
174
166
  "parameters": [
175
167
  {
176
168
  "name": "Publer-Workspace-Id",
@@ -178,25 +170,38 @@
178
170
  "schema": {
179
171
  "type": "string"
180
172
  },
181
- "example": "{{workspace_id}}"
173
+ "example": "{{workspace_id}}",
174
+ "required": true
182
175
  }
183
176
  ],
184
177
  "responses": {
185
178
  "200": {
186
179
  "description": "Successful response",
187
180
  "content": {
188
- "application/json": {}
181
+ "application/json": {
182
+ "schema": {
183
+ "type": "object",
184
+ "properties": {
185
+ "accounts": {
186
+ "type": "array",
187
+ "items": {
188
+ "$ref": "#/components/schemas/Account"
189
+ }
190
+ }
191
+ }
192
+ }
193
+ }
189
194
  }
190
195
  }
191
196
  }
192
197
  }
193
198
  },
194
- "/api/v1/media": {
199
+ "/media": {
195
200
  "get": {
196
201
  "tags": [
197
202
  "MEDIA"
198
203
  ],
199
- "summary": "LIST MEDIA",
204
+ "summary": "List media",
200
205
  "parameters": [
201
206
  {
202
207
  "name": "Publer-Workspace-Id",
@@ -204,23 +209,68 @@
204
209
  "schema": {
205
210
  "type": "string"
206
211
  },
207
- "example": "{{workspace_id}}"
212
+ "example": "{{workspace_id}}",
213
+ "required": true
214
+ },
215
+ {
216
+ "name": "ids[]",
217
+ "in": "query",
218
+ "schema": {
219
+ "type": "array",
220
+ "items": {
221
+ "type": "string"
222
+ }
223
+ },
224
+ "example": ["647a0edddb2797b89044e2c1"]
225
+ },
226
+ {
227
+ "name": "page",
228
+ "in": "query",
229
+ "schema": {
230
+ "type": "integer"
231
+ },
232
+ "example": 0
208
233
  },
209
234
  {
210
235
  "name": "types[]",
211
236
  "in": "query",
212
237
  "schema": {
213
- "type": "string"
238
+ "type": "array",
239
+ "items": {
240
+ "type": "string",
241
+ "enum": ["photo", "video", "gif"]
242
+ }
214
243
  },
215
- "example": "photo"
244
+ "example": ["photo"]
216
245
  },
217
246
  {
218
247
  "name": "used[]",
219
248
  "in": "query",
220
249
  "schema": {
221
- "type": "boolean"
250
+ "type": "array",
251
+ "items": {
252
+ "type": "boolean"
253
+ }
222
254
  },
223
- "example": "false"
255
+ "example": [false]
256
+ },
257
+ {
258
+ "name": "source[]",
259
+ "in": "query",
260
+ "schema": {
261
+ "type": "array",
262
+ "items": {
263
+ "type": "string",
264
+ "enum": ["canva", "vista", "postnitro", "contentdrips", "openai", "favorites", "upload"]
265
+ }
266
+ }
267
+ },
268
+ {
269
+ "name": "search",
270
+ "in": "query",
271
+ "schema": {
272
+ "type": "string"
273
+ }
224
274
  }
225
275
  ],
226
276
  "responses": {
@@ -231,14 +281,12 @@
231
281
  }
232
282
  }
233
283
  }
234
- }
235
- },
236
- "/api/v1/media/": {
284
+ },
237
285
  "post": {
238
286
  "tags": [
239
287
  "MEDIA"
240
288
  ],
241
- "summary": "UPLOAD FILE",
289
+ "summary": "Upload file",
242
290
  "requestBody": {
243
291
  "content": {
244
292
  "multipart/form-data": {
@@ -251,11 +299,11 @@
251
299
  },
252
300
  "direct_upload": {
253
301
  "type": "boolean",
254
- "example": "false"
302
+ "example": false
255
303
  },
256
304
  "in_library": {
257
305
  "type": "boolean",
258
- "example": "true"
306
+ "example": true
259
307
  }
260
308
  }
261
309
  }
@@ -269,7 +317,8 @@
269
317
  "schema": {
270
318
  "type": "string"
271
319
  },
272
- "example": "{{workspace_id}}"
320
+ "example": "{{workspace_id}}",
321
+ "required": true
273
322
  }
274
323
  ],
275
324
  "responses": {
@@ -282,29 +331,63 @@
282
331
  }
283
332
  }
284
333
  },
285
- "/api/v1/media/from-url": {
334
+ "/media/from-url": {
286
335
  "post": {
287
336
  "tags": [
288
337
  "MEDIA"
289
338
  ],
290
- "summary": "UPLOAD FROM URL",
339
+ "summary": "Upload from url",
291
340
  "requestBody": {
292
341
  "content": {
293
342
  "application/json": {
294
343
  "schema": {
295
344
  "type": "object",
296
- "example": {
297
- "media": [
298
- {
299
- "url": "https://api.unsplash.com/photos/910B32-V0E4/download?ixid=M3wxNjI3NDR8MHwxfGFsbHw1M3x8fHx8fDJ8fDE3NDk2MzE4MzN8&client_id=F2Rc11lPwYuERzKFAPluEfH_QYb_mM7qI6_6PGT55ZI",
300
- "name": "Whirpool",
301
- "caption": "Photo by Fadhil Abhimantra on Unsplash:\n\nhttps://unsplash.com/photos/waves-crash-against-a-rocky-coastline-910B32-V0E4",
302
- "source": "unsplash"
345
+ "required": ["media", "type"],
346
+ "properties": {
347
+ "media": {
348
+ "type": "array",
349
+ "description": "List of media URLs and metadata",
350
+ "items": {
351
+ "type": "object",
352
+ "required": ["url", "name"],
353
+ "properties": {
354
+ "url": {
355
+ "type": "string",
356
+ "description": "URL of the media file to download"
357
+ },
358
+ "name": {
359
+ "type": "string",
360
+ "description": "Custom name for the media file"
361
+ },
362
+ "caption": {
363
+ "type": "string",
364
+ "description": "Caption for the media"
365
+ },
366
+ "source": {
367
+ "type": "string",
368
+ "description": "Source attribution"
369
+ }
370
+ }
303
371
  }
304
- ],
305
- "type": "single",
306
- "direct_upload": false,
307
- "in_library": true
372
+ },
373
+ "type": {
374
+ "type": "string",
375
+ "enum": ["single", "bulk", "thumbnail"],
376
+ "description": "Upload type",
377
+ "example": "single"
378
+ },
379
+ "direct_upload": {
380
+ "type": "boolean",
381
+ "description": "Whether to upload directly to S3 cloud, slower but returns id",
382
+ "default": false,
383
+ "example": false
384
+ },
385
+ "in_library": {
386
+ "type": "boolean",
387
+ "description": "Whether to save to media library",
388
+ "default": false,
389
+ "example": true
390
+ }
308
391
  }
309
392
  }
310
393
  }
@@ -317,7 +400,8 @@
317
400
  "schema": {
318
401
  "type": "string"
319
402
  },
320
- "example": "{{workspace_id}}"
403
+ "example": "{{workspace_id}}",
404
+ "required": true
321
405
  }
322
406
  ],
323
407
  "responses": {
@@ -330,44 +414,127 @@
330
414
  }
331
415
  }
332
416
  },
333
- "/api/v1/posts/schedule": {
417
+ "/posts/schedule": {
334
418
  "post": {
335
419
  "tags": [
336
420
  "POSTS > CONTENT TYPES"
337
421
  ],
338
- "summary": "POST WITH LOCATIONS",
422
+ "summary": "Schedule post",
423
+ "description": "Schedule a post. Supports text, photo, video, link, carousel, story, reel, and gif content types.",
339
424
  "requestBody": {
340
425
  "content": {
341
426
  "application/json": {
342
427
  "schema": {
343
428
  "type": "object",
344
- "example": {
429
+ "required": ["bulk"],
430
+ "properties": {
345
431
  "bulk": {
346
- "state": "scheduled",
347
- "posts": [
348
- {
349
- "networks": {
350
- "facebook": {
351
- "type": "status",
352
- "text": "Facebook location"
353
- }
354
- },
355
- "accounts": [
356
- {
357
- "id": "647a0edddb2797b89044e2c1",
358
- "scheduled_at": "2025-06-14T10:21+02:00",
359
- "location": {
360
- "id": "308281375929281",
361
- "name": "Tirana",
362
- "info": "Tirana, Albania ⋅ 590 follow this",
363
- "verified": null,
364
- "address": "Tirana, Albania",
365
- "checkins": "590"
432
+ "type": "object",
433
+ "required": ["state", "posts"],
434
+ "properties": {
435
+ "state": {
436
+ "type": "string",
437
+ "enum": ["scheduled", "draft"],
438
+ "description": "Post state",
439
+ "example": "scheduled"
440
+ },
441
+ "posts": {
442
+ "type": "array",
443
+ "description": "Posts to create",
444
+ "items": {
445
+ "type": "object",
446
+ "required": ["networks", "accounts"],
447
+ "properties": {
448
+ "networks": {
449
+ "type": "object",
450
+ "description": "Network-specific post content",
451
+ "additionalProperties": {
452
+ "type": "object",
453
+ "description": "Per-network post configuration",
454
+ "properties": {
455
+ "type": {
456
+ "type": "string",
457
+ "enum": ["status", "photo", "video", "link", "carousel", "story", "reel", "gif"],
458
+ "description": "Content type: status (text only), photo, video, link, carousel, story, reel, or gif",
459
+ "example": "status"
460
+ },
461
+ "text": {
462
+ "type": "string",
463
+ "description": "Post text content",
464
+ "example": "Hello world!"
465
+ },
466
+ "media": {
467
+ "type": "array",
468
+ "description": "Media attachments (required for photo, video, carousel, story, reel, gif types)",
469
+ "items": {
470
+ "type": "object",
471
+ "properties": {
472
+ "id": {
473
+ "type": "string",
474
+ "description": "Media asset ID from upload"
475
+ },
476
+ "type": {
477
+ "type": "string",
478
+ "enum": ["photo", "video", "gif"],
479
+ "description": "Media type"
480
+ },
481
+ "caption": {
482
+ "type": "string",
483
+ "description": "Media caption"
484
+ }
485
+ }
486
+ }
487
+ },
488
+ "url": {
489
+ "type": "string",
490
+ "description": "URL for link posts (required when type=link)",
491
+ "example": "https://publer.com"
492
+ }
493
+ }
494
+ }
495
+ },
496
+ "accounts": {
497
+ "type": "array",
498
+ "description": "Target social media accounts",
499
+ "items": {
500
+ "type": "object",
501
+ "required": ["id"],
502
+ "properties": {
503
+ "id": {
504
+ "type": "string",
505
+ "description": "Account ID",
506
+ "example": "647a0edddb2797b89044e2c1"
507
+ },
508
+ "scheduled_at": {
509
+ "type": "string",
510
+ "description": "ISO 8601 scheduled time",
511
+ "example": "2025-06-14T10:21+02:00"
512
+ },
513
+ "location": {
514
+ "type": "object",
515
+ "description": "Location for Facebook/Instagram",
516
+ "properties": {
517
+ "id": {
518
+ "type": "string",
519
+ "description": "Location ID"
520
+ },
521
+ "name": {
522
+ "type": "string",
523
+ "description": "Location name"
524
+ },
525
+ "address": {
526
+ "type": "string",
527
+ "description": "Location address"
528
+ }
529
+ }
530
+ }
531
+ }
532
+ }
366
533
  }
367
534
  }
368
- ]
535
+ }
369
536
  }
370
- ]
537
+ }
371
538
  }
372
539
  }
373
540
  }
@@ -381,7 +548,8 @@
381
548
  "schema": {
382
549
  "type": "string"
383
550
  },
384
- "example": "{{workspace_id}}"
551
+ "example": "{{workspace_id}}",
552
+ "required": true
385
553
  }
386
554
  ],
387
555
  "responses": {
@@ -394,36 +562,109 @@
394
562
  }
395
563
  }
396
564
  },
397
- "/api/v1/posts/schedule/publish": {
565
+ "/posts/schedule/publish": {
398
566
  "post": {
399
567
  "tags": [
400
568
  "POSTS > PUBLISHING METHODS"
401
569
  ],
402
- "summary": "PUBLISH",
570
+ "summary": "Publish immediately",
571
+ "description": "Publish a post immediately. Supports text, photo, video, link, carousel, story, reel, and gif content types.",
403
572
  "requestBody": {
404
573
  "content": {
405
574
  "application/json": {
406
575
  "schema": {
407
576
  "type": "object",
408
- "example": {
577
+ "required": ["bulk"],
578
+ "properties": {
409
579
  "bulk": {
410
- "state": "scheduled",
411
- "url": "publish",
412
- "posts": [
413
- {
414
- "networks": {
415
- "facebook": {
416
- "type": "status",
417
- "text": "Just published this update via the Publer API! #RealTimePosting"
418
- }
419
- },
420
- "accounts": [
421
- {
422
- "id": "647a0edddb2797b89044e2c1"
580
+ "type": "object",
581
+ "required": ["state", "posts"],
582
+ "properties": {
583
+ "state": {
584
+ "type": "string",
585
+ "enum": ["published"],
586
+ "description": "Must be 'published' for immediate publishing",
587
+ "example": "published"
588
+ },
589
+ "url": {
590
+ "type": "string",
591
+ "description": "Must be 'publish'",
592
+ "example": "publish"
593
+ },
594
+ "posts": {
595
+ "type": "array",
596
+ "description": "Posts to publish",
597
+ "items": {
598
+ "type": "object",
599
+ "required": ["networks", "accounts"],
600
+ "properties": {
601
+ "networks": {
602
+ "type": "object",
603
+ "description": "Network-specific post content",
604
+ "additionalProperties": {
605
+ "type": "object",
606
+ "description": "Per-network post configuration",
607
+ "properties": {
608
+ "type": {
609
+ "type": "string",
610
+ "enum": ["status", "photo", "video", "link", "carousel", "story", "reel", "gif"],
611
+ "description": "Content type: status (text only), photo, video, link, carousel, story, reel, or gif",
612
+ "example": "status"
613
+ },
614
+ "text": {
615
+ "type": "string",
616
+ "description": "Post text content",
617
+ "example": "Hello world!"
618
+ },
619
+ "media": {
620
+ "type": "array",
621
+ "description": "Media attachments (required for photo, video, carousel, story, reel, gif types)",
622
+ "items": {
623
+ "type": "object",
624
+ "properties": {
625
+ "id": {
626
+ "type": "string",
627
+ "description": "Media asset ID from upload"
628
+ },
629
+ "type": {
630
+ "type": "string",
631
+ "enum": ["photo", "video", "gif"],
632
+ "description": "Media type"
633
+ },
634
+ "caption": {
635
+ "type": "string",
636
+ "description": "Media caption"
637
+ }
638
+ }
639
+ }
640
+ },
641
+ "url": {
642
+ "type": "string",
643
+ "description": "URL for link posts (required when type=link)",
644
+ "example": "https://publer.com"
645
+ }
646
+ }
647
+ }
648
+ },
649
+ "accounts": {
650
+ "type": "array",
651
+ "description": "Target social media accounts",
652
+ "items": {
653
+ "type": "object",
654
+ "required": ["id"],
655
+ "properties": {
656
+ "id": {
657
+ "type": "string",
658
+ "description": "Account ID",
659
+ "example": "647a0edddb2797b89044e2c1"
660
+ }
661
+ }
662
+ }
663
+ }
423
664
  }
424
- ]
665
+ }
425
666
  }
426
- ]
667
+ }
427
668
  }
428
669
  }
429
670
  }
@@ -437,7 +678,8 @@
437
678
  "schema": {
438
679
  "type": "string"
439
680
  },
440
- "example": "{{workspace_id}}"
681
+ "example": "{{workspace_id}}",
682
+ "required": true
441
683
  }
442
684
  ],
443
685
  "responses": {
@@ -450,12 +692,12 @@
450
692
  }
451
693
  }
452
694
  },
453
- "/api/v1/posts": {
695
+ "/posts": {
454
696
  "get": {
455
697
  "tags": [
456
698
  "POSTS"
457
699
  ],
458
- "summary": "GET POSTS",
700
+ "summary": "List Posts",
459
701
  "parameters": [
460
702
  {
461
703
  "name": "Publer-Workspace-Id",
@@ -463,23 +705,87 @@
463
705
  "schema": {
464
706
  "type": "string"
465
707
  },
466
- "example": "{{workspace_id}}"
708
+ "example": "{{workspace_id}}",
709
+ "required": true
467
710
  },
468
711
  {
469
712
  "name": "state",
470
713
  "in": "query",
471
714
  "schema": {
472
- "type": "string"
715
+ "type": "string",
716
+ "enum": ["all", "scheduled", "scheduled_approved", "scheduled_pending", "scheduled_declined", "scheduled_reauth", "scheduled_locked", "published", "published_posted", "published_deleted", "published_hidden", "draft", "draft_dated", "draft_undated", "draft_private", "draft_public", "failed", "recycling", "recycling_active", "recycling_paused", "recycling_expired", "recycling_failed", "recycling_pending", "recycling_declined", "recycling_reauth", "recycling_locked", "recurring"]
473
717
  },
474
718
  "example": "scheduled"
475
719
  },
720
+ {
721
+ "name": "state[]",
722
+ "in": "query",
723
+ "schema": {
724
+ "type": "array",
725
+ "items": {
726
+ "type": "string",
727
+ "enum": ["all", "scheduled", "scheduled_approved", "scheduled_pending", "scheduled_declined", "scheduled_reauth", "scheduled_locked", "published", "published_posted", "published_deleted", "published_hidden", "draft", "draft_dated", "draft_undated", "draft_private", "draft_public", "failed", "recycling", "recycling_active", "recycling_paused", "recycling_expired", "recycling_failed", "recycling_pending", "recycling_declined", "recycling_reauth", "recycling_locked", "recurring"]
728
+ }
729
+ }
730
+ },
731
+ {
732
+ "name": "from",
733
+ "in": "query",
734
+ "schema": {
735
+ "type": "string",
736
+ "format": "date"
737
+ },
738
+ "example": "2025-01-01"
739
+ },
740
+ {
741
+ "name": "to",
742
+ "in": "query",
743
+ "schema": {
744
+ "type": "string",
745
+ "format": "date"
746
+ },
747
+ "example": "2025-12-31"
748
+ },
476
749
  {
477
750
  "name": "page",
478
751
  "in": "query",
479
752
  "schema": {
480
753
  "type": "integer"
481
754
  },
482
- "example": "0"
755
+ "example": 0
756
+ },
757
+ {
758
+ "name": "account_ids[]",
759
+ "in": "query",
760
+ "schema": {
761
+ "type": "array",
762
+ "items": {
763
+ "type": "string"
764
+ }
765
+ },
766
+ "example": ["63c675b54e299e9cf2b667ea"]
767
+ },
768
+ {
769
+ "name": "query",
770
+ "in": "query",
771
+ "schema": {
772
+ "type": "string"
773
+ }
774
+ },
775
+ {
776
+ "name": "postType",
777
+ "in": "query",
778
+ "schema": {
779
+ "type": "string",
780
+ "enum": ["status", "link", "photo", "gif", "video", "reel", "story", "short", "poll", "document", "carousel", "article"]
781
+ }
782
+ },
783
+ {
784
+ "name": "member_id",
785
+ "in": "query",
786
+ "schema": {
787
+ "type": "string"
788
+ }
483
789
  }
484
790
  ],
485
791
  "responses": {
@@ -495,7 +801,7 @@
495
801
  "tags": [
496
802
  "POSTS"
497
803
  ],
498
- "summary": "DELETE POSTS",
804
+ "summary": "Delete posts",
499
805
  "parameters": [
500
806
  {
501
807
  "name": "Publer-Workspace-Id",
@@ -503,15 +809,19 @@
503
809
  "schema": {
504
810
  "type": "string"
505
811
  },
506
- "example": "{{workspace_id}}"
812
+ "example": "{{workspace_id}}",
813
+ "required": true
507
814
  },
508
815
  {
509
816
  "name": "post_ids[]",
510
817
  "in": "query",
511
818
  "schema": {
512
- "type": "string"
819
+ "type": "array",
820
+ "items": {
821
+ "type": "string"
822
+ }
513
823
  },
514
- "example": "684945796a88bf9baa9c182c"
824
+ "example": ["684945796a88bf9baa9c182c"]
515
825
  }
516
826
  ],
517
827
  "responses": {
@@ -524,12 +834,12 @@
524
834
  }
525
835
  }
526
836
  },
527
- "/api/v1/posts/links": {
837
+ "/posts/links": {
528
838
  "post": {
529
839
  "tags": [
530
840
  "POSTS"
531
841
  ],
532
- "summary": "EXTRACT LINK METADATA",
842
+ "summary": "Extract link metadata",
533
843
  "requestBody": {
534
844
  "content": {
535
845
  "application/json": {
@@ -552,35 +862,29 @@
552
862
  }
553
863
  }
554
864
  },
555
- "/api/v1/posts/684945796a88bf9baa9c182c": {
865
+ "/posts/{post_id}": {
556
866
  "put": {
557
867
  "tags": [
558
868
  "POSTS"
559
869
  ],
560
- "summary": "UPDATE POST",
561
- "requestBody": {
562
- "content": {
563
- "application/json": {
564
- "schema": {
565
- "type": "object",
566
- "example": {
567
- "post": {
568
- "text": "Status Update UPDATED",
569
- "title": null
570
- }
571
- }
572
- }
573
- }
574
- }
575
- },
870
+ "summary": "Update post",
576
871
  "parameters": [
872
+ {
873
+ "name": "post_id",
874
+ "in": "path",
875
+ "schema": {
876
+ "type": "string"
877
+ },
878
+ "required": true
879
+ },
577
880
  {
578
881
  "name": "Publer-Workspace-Id",
579
882
  "in": "header",
580
883
  "schema": {
581
884
  "type": "string"
582
885
  },
583
- "example": "{{workspace_id}}"
886
+ "example": "{{workspace_id}}",
887
+ "required": true
584
888
  }
585
889
  ],
586
890
  "responses": {
@@ -593,20 +897,29 @@
593
897
  }
594
898
  }
595
899
  },
596
- "/api/v1/job_status/6849530cdd9d40170723cd66": {
900
+ "/job_status/{job_id}": {
597
901
  "get": {
598
902
  "tags": [
599
903
  "JOB STATUS"
600
904
  ],
601
- "summary": "JOB STATUS",
905
+ "summary": "Job status",
602
906
  "parameters": [
907
+ {
908
+ "name": "job_id",
909
+ "in": "path",
910
+ "schema": {
911
+ "type": "string"
912
+ },
913
+ "required": true
914
+ },
603
915
  {
604
916
  "name": "Publer-Workspace-Id",
605
917
  "in": "header",
606
918
  "schema": {
607
919
  "type": "string"
608
920
  },
609
- "example": "{{workspace_id}}"
921
+ "example": "{{workspace_id}}",
922
+ "required": true
610
923
  }
611
924
  ],
612
925
  "responses": {
@@ -619,12 +932,12 @@
619
932
  }
620
933
  }
621
934
  },
622
- "/api/v1/locations/instagram": {
935
+ "/locations/instagram": {
623
936
  "get": {
624
937
  "tags": [
625
938
  "LOCATIONS"
626
939
  ],
627
- "summary": "INSTAGRAM LOCATIONS",
940
+ "summary": "Instagram locations",
628
941
  "parameters": [
629
942
  {
630
943
  "name": "Publer-Workspace-Id",
@@ -632,7 +945,8 @@
632
945
  "schema": {
633
946
  "type": "string"
634
947
  },
635
- "example": "{{workspace_id}}"
948
+ "example": "{{workspace_id}}",
949
+ "required": true
636
950
  },
637
951
  {
638
952
  "name": "q",
@@ -640,7 +954,7 @@
640
954
  "schema": {
641
955
  "type": "string"
642
956
  },
643
- "example": "Tirana\n"
957
+ "example": "Tirana"
644
958
  }
645
959
  ],
646
960
  "responses": {
@@ -653,12 +967,12 @@
653
967
  }
654
968
  }
655
969
  },
656
- "/api/v1/locations/facebook": {
970
+ "/locations/facebook": {
657
971
  "get": {
658
972
  "tags": [
659
973
  "LOCATIONS"
660
974
  ],
661
- "summary": "FACEBOOK LOCATIONS",
975
+ "summary": "Facebook locations",
662
976
  "parameters": [
663
977
  {
664
978
  "name": "Publer-Workspace-Id",
@@ -666,7 +980,8 @@
666
980
  "schema": {
667
981
  "type": "string"
668
982
  },
669
- "example": "{{workspace_id}}"
983
+ "example": "{{workspace_id}}",
984
+ "required": true
670
985
  },
671
986
  {
672
987
  "name": "q",
@@ -674,7 +989,7 @@
674
989
  "schema": {
675
990
  "type": "string"
676
991
  },
677
- "example": "Tirana\n"
992
+ "example": "Tirana"
678
993
  }
679
994
  ],
680
995
  "responses": {
@@ -687,12 +1002,12 @@
687
1002
  }
688
1003
  }
689
1004
  },
690
- "/api/v1/locations/threads": {
1005
+ "/locations/threads": {
691
1006
  "get": {
692
1007
  "tags": [
693
1008
  "LOCATIONS"
694
1009
  ],
695
- "summary": "THREADS LOCATIONS",
1010
+ "summary": "Threads locations",
696
1011
  "parameters": [
697
1012
  {
698
1013
  "name": "Publer-Workspace-Id",
@@ -700,7 +1015,8 @@
700
1015
  "schema": {
701
1016
  "type": "string"
702
1017
  },
703
- "example": "{{workspace_id}}"
1018
+ "example": "{{workspace_id}}",
1019
+ "required": true
704
1020
  },
705
1021
  {
706
1022
  "name": "q",
@@ -708,7 +1024,7 @@
708
1024
  "schema": {
709
1025
  "type": "string"
710
1026
  },
711
- "example": "Tirana\n"
1027
+ "example": "Tirana"
712
1028
  }
713
1029
  ],
714
1030
  "responses": {
@@ -721,12 +1037,12 @@
721
1037
  }
722
1038
  }
723
1039
  },
724
- "/api/v1/analytics/charts": {
1040
+ "/analytics/charts": {
725
1041
  "get": {
726
1042
  "tags": [
727
1043
  "ANALYTICS"
728
1044
  ],
729
- "summary": "GET CHARTS",
1045
+ "summary": "Get charts",
730
1046
  "parameters": [
731
1047
  {
732
1048
  "name": "Publer-Workspace-Id",
@@ -734,7 +1050,8 @@
734
1050
  "schema": {
735
1051
  "type": "string"
736
1052
  },
737
- "example": "{{workspace_id}}"
1053
+ "example": "{{workspace_id}}",
1054
+ "required": true
738
1055
  }
739
1056
  ],
740
1057
  "responses": {
@@ -747,12 +1064,12 @@
747
1064
  }
748
1065
  }
749
1066
  },
750
- "/api/v1/analytics/{account_id}/chart_data": {
1067
+ "/analytics/{account_id}/chart_data": {
751
1068
  "get": {
752
1069
  "tags": [
753
1070
  "ANALYTICS"
754
1071
  ],
755
- "summary": "CHARTS DATA",
1072
+ "summary": "Charts data",
756
1073
  "parameters": [
757
1074
  {
758
1075
  "name": "Publer-Workspace-Id",
@@ -760,7 +1077,8 @@
760
1077
  "schema": {
761
1078
  "type": "string"
762
1079
  },
763
- "example": "{{workspace_id}}"
1080
+ "example": "{{workspace_id}}",
1081
+ "required": true
764
1082
  },
765
1083
  {
766
1084
  "name": "from",
@@ -782,9 +1100,12 @@
782
1100
  "name": "chart_ids[]",
783
1101
  "in": "query",
784
1102
  "schema": {
785
- "type": "string"
1103
+ "type": "array",
1104
+ "items": {
1105
+ "type": "string"
1106
+ }
786
1107
  },
787
- "example": "followers"
1108
+ "example": ["followers"]
788
1109
  },
789
1110
  {
790
1111
  "name": "account_id",
@@ -805,12 +1126,12 @@
805
1126
  }
806
1127
  }
807
1128
  },
808
- "/api/v1/analytics/{account_id}/post_insights": {
1129
+ "/analytics/{account_id}/post_insights": {
809
1130
  "get": {
810
1131
  "tags": [
811
1132
  "ANALYTICS"
812
1133
  ],
813
- "summary": "POST INSIGHTS",
1134
+ "summary": "Post insights",
814
1135
  "parameters": [
815
1136
  {
816
1137
  "name": "Publer-Workspace-Id",
@@ -818,7 +1139,8 @@
818
1139
  "schema": {
819
1140
  "type": "string"
820
1141
  },
821
- "example": "{{workspace_id}}"
1142
+ "example": "{{workspace_id}}",
1143
+ "required": true
822
1144
  },
823
1145
  {
824
1146
  "name": "from",
@@ -842,7 +1164,7 @@
842
1164
  "schema": {
843
1165
  "type": "integer"
844
1166
  },
845
- "example": "0"
1167
+ "example": 0
846
1168
  },
847
1169
  {
848
1170
  "name": "account_id",
@@ -863,12 +1185,12 @@
863
1185
  }
864
1186
  }
865
1187
  },
866
- "/api/v1/analytics/{account_id}/hashtag_insights": {
1188
+ "/analytics/{account_id}/hashtag_insights": {
867
1189
  "get": {
868
1190
  "tags": [
869
1191
  "ANALYTICS"
870
1192
  ],
871
- "summary": "HASHTAG INSIGHTS",
1193
+ "summary": "Hashtag insights",
872
1194
  "parameters": [
873
1195
  {
874
1196
  "name": "Publer-Workspace-Id",
@@ -876,7 +1198,8 @@
876
1198
  "schema": {
877
1199
  "type": "string"
878
1200
  },
879
- "example": "{{workspace_id}}"
1201
+ "example": "{{workspace_id}}",
1202
+ "required": true
880
1203
  },
881
1204
  {
882
1205
  "name": "from",
@@ -913,12 +1236,12 @@
913
1236
  }
914
1237
  }
915
1238
  },
916
- "/api/v1/analytics/{account_id}/hashtag_performing_posts": {
1239
+ "/analytics/{account_id}/hashtag_performing_posts": {
917
1240
  "get": {
918
1241
  "tags": [
919
1242
  "ANALYTICS"
920
1243
  ],
921
- "summary": "HASHTAG PERFOMING POSTS",
1244
+ "summary": "Hashtag performing posts",
922
1245
  "parameters": [
923
1246
  {
924
1247
  "name": "Publer-Workspace-Id",
@@ -926,7 +1249,8 @@
926
1249
  "schema": {
927
1250
  "type": "string"
928
1251
  },
929
- "example": "{{workspace_id}}"
1252
+ "example": "{{workspace_id}}",
1253
+ "required": true
930
1254
  },
931
1255
  {
932
1256
  "name": "hashtag",
@@ -972,12 +1296,12 @@
972
1296
  }
973
1297
  }
974
1298
  },
975
- "/api/v1/analytics/{account_id}best_times": {
1299
+ "/analytics/{account_id}/best_times": {
976
1300
  "get": {
977
1301
  "tags": [
978
1302
  "ANALYTICS"
979
1303
  ],
980
- "summary": "BEST TIMES TO POST",
1304
+ "summary": "Best times to post",
981
1305
  "parameters": [
982
1306
  {
983
1307
  "name": "Publer-Workspace-Id",
@@ -985,7 +1309,8 @@
985
1309
  "schema": {
986
1310
  "type": "string"
987
1311
  },
988
- "example": "{{workspace_id}}"
1312
+ "example": "{{workspace_id}}",
1313
+ "required": true
989
1314
  },
990
1315
  {
991
1316
  "name": "from",
@@ -1022,12 +1347,12 @@
1022
1347
  }
1023
1348
  }
1024
1349
  },
1025
- "/api/v1/analytics/members": {
1350
+ "/analytics/members": {
1026
1351
  "get": {
1027
1352
  "tags": [
1028
1353
  "ANALYTICS"
1029
1354
  ],
1030
- "summary": "MEMBERS",
1355
+ "summary": "Members",
1031
1356
  "parameters": [
1032
1357
  {
1033
1358
  "name": "Publer-Workspace-Id",
@@ -1035,7 +1360,8 @@
1035
1360
  "schema": {
1036
1361
  "type": "string"
1037
1362
  },
1038
- "example": "{{workspace_id}}"
1363
+ "example": "{{workspace_id}}",
1364
+ "required": true
1039
1365
  },
1040
1366
  {
1041
1367
  "name": "from",
@@ -1064,12 +1390,12 @@
1064
1390
  }
1065
1391
  }
1066
1392
  },
1067
- "/api/v1/competitors": {
1393
+ "/competitors": {
1068
1394
  "get": {
1069
1395
  "tags": [
1070
1396
  "ANALYTICS"
1071
1397
  ],
1072
- "summary": "COMPETITORS",
1398
+ "summary": "Competitors",
1073
1399
  "parameters": [
1074
1400
  {
1075
1401
  "name": "Publer-Workspace-Id",
@@ -1077,7 +1403,8 @@
1077
1403
  "schema": {
1078
1404
  "type": "string"
1079
1405
  },
1080
- "example": "{{workspace_id}}"
1406
+ "example": "{{workspace_id}}",
1407
+ "required": true
1081
1408
  }
1082
1409
  ],
1083
1410
  "responses": {
@@ -1090,20 +1417,29 @@
1090
1417
  }
1091
1418
  }
1092
1419
  },
1093
- "/api/v1/competitors/66e011b94e299eb49376c715/analytics": {
1420
+ "/competitors/{competitor_id}/analytics": {
1094
1421
  "get": {
1095
1422
  "tags": [
1096
1423
  "ANALYTICS"
1097
1424
  ],
1098
- "summary": "COMPETITORS ANALYTICS",
1425
+ "summary": "Competitors analytics",
1099
1426
  "parameters": [
1427
+ {
1428
+ "name": "competitor_id",
1429
+ "in": "path",
1430
+ "schema": {
1431
+ "type": "string"
1432
+ },
1433
+ "required": true
1434
+ },
1100
1435
  {
1101
1436
  "name": "Publer-Workspace-Id",
1102
1437
  "in": "header",
1103
1438
  "schema": {
1104
1439
  "type": "string"
1105
1440
  },
1106
- "example": "{{workspace_id}}"
1441
+ "example": "{{workspace_id}}",
1442
+ "required": true
1107
1443
  },
1108
1444
  {
1109
1445
  "name": "from",
@@ -1127,7 +1463,7 @@
1127
1463
  "schema": {
1128
1464
  "type": "integer"
1129
1465
  },
1130
- "example": "0"
1466
+ "example": 0
1131
1467
  }
1132
1468
  ],
1133
1469
  "responses": {
@@ -1140,5 +1476,52 @@
1140
1476
  }
1141
1477
  }
1142
1478
  }
1479
+ },
1480
+ "components": {
1481
+ "schemas": {
1482
+ "Account": {
1483
+ "type": "object",
1484
+ "properties": {
1485
+ "id": {
1486
+ "type": "string",
1487
+ "description": "Unique identifier for the account"
1488
+ },
1489
+ "provider": {
1490
+ "type": "string",
1491
+ "description": "The social network provider",
1492
+ "enum": ["bluesky", "facebook", "instagram", "linkedin", "twitter", "tiktok", "youtube", "pinterest", "google", "wordpress", "telegram", "mastodon", "threads"]
1493
+ },
1494
+ "name": {
1495
+ "type": "string",
1496
+ "description": "The display name of the social media account"
1497
+ },
1498
+ "social_id": {
1499
+ "type": "string",
1500
+ "description": "Unique identifier for the account on the social media platform"
1501
+ },
1502
+ "picture": {
1503
+ "type": "string",
1504
+ "description": "URL to the account's avatar/logo"
1505
+ },
1506
+ "type": {
1507
+ "type": "string",
1508
+ "description": "Account type",
1509
+ "enum": ["page", "profile", "group", "business", "channel", "location", "blog"]
1510
+ },
1511
+ "status": {
1512
+ "type": "string",
1513
+ "description": "Account status"
1514
+ }
1515
+ }
1516
+ }
1517
+ },
1518
+ "securitySchemes": {
1519
+ "bearerAuth": {
1520
+ "type": "apiKey",
1521
+ "name": "Authorization",
1522
+ "in": "header",
1523
+ "description": "API key authentication. Format: \"Bearer-API YOUR_API_KEY\""
1524
+ }
1525
+ }
1143
1526
  }
1144
1527
  }
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptive-ds/n8n-nodes-publer",
3
- "version": "1.1.6",
3
+ "version": "1.1.8",
4
4
  "description": "n8n node to connect with Publer.com social media management API",
5
5
  "keywords": [
6
6
  "n8n",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@adaptive-ds/n8n-nodes-publer",
3
- "version": "1.1.6",
3
+ "version": "1.1.8",
4
4
  "description": "n8n node to connect with Publer.com social media management API",
5
5
  "keywords": [
6
6
  "n8n",