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

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 (75) hide show
  1. package/dist/credentials/PublerApi.credentials.d.ts +2 -2
  2. package/dist/credentials/PublerApi.credentials.js +16 -16
  3. package/dist/credentials/PublerApi.credentials.js.map +1 -1
  4. package/dist/nodes/PublerAnalytics/PublerAnalytics.node.d.ts +4 -0
  5. package/dist/nodes/PublerAnalytics/PublerAnalytics.node.js +75 -0
  6. package/dist/nodes/PublerAnalytics/PublerAnalytics.node.js.map +1 -0
  7. package/dist/nodes/PublerAnalytics/PublerAnalytics.spec.js +8 -0
  8. package/dist/nodes/PublerAnalytics/PublerAnalytics.spec.js.map +1 -0
  9. package/dist/nodes/PublerAnalytics/logo.svg +44 -0
  10. package/dist/nodes/PublerAnalytics/openapi.json +777 -0
  11. package/dist/nodes/{Publer/Publer.node.d.ts → PublerBasic/PublerBasic.node.d.ts} +1 -1
  12. package/dist/nodes/PublerBasic/PublerBasic.node.js +75 -0
  13. package/dist/nodes/PublerBasic/PublerBasic.node.js.map +1 -0
  14. package/dist/nodes/PublerBasic/PublerBasic.spec.d.ts +1 -0
  15. package/dist/nodes/PublerBasic/PublerBasic.spec.js +8 -0
  16. package/dist/nodes/PublerBasic/PublerBasic.spec.js.map +1 -0
  17. package/dist/nodes/PublerBasic/logo.svg +44 -0
  18. package/dist/nodes/PublerBasic/openapi.json +507 -0
  19. package/dist/nodes/PublerCompetitors/PublerCompetitors.node.d.ts +4 -0
  20. package/dist/nodes/PublerCompetitors/PublerCompetitors.node.js +75 -0
  21. package/dist/nodes/PublerCompetitors/PublerCompetitors.node.js.map +1 -0
  22. package/dist/nodes/PublerCompetitors/PublerCompetitors.spec.d.ts +1 -0
  23. package/dist/nodes/PublerCompetitors/PublerCompetitors.spec.js +8 -0
  24. package/dist/nodes/PublerCompetitors/PublerCompetitors.spec.js.map +1 -0
  25. package/dist/nodes/PublerCompetitors/logo.svg +44 -0
  26. package/dist/nodes/PublerCompetitors/openapi.json +264 -0
  27. package/dist/nodes/PublerLocations/PublerLocations.node.d.ts +4 -0
  28. package/dist/nodes/PublerLocations/PublerLocations.node.js +75 -0
  29. package/dist/nodes/PublerLocations/PublerLocations.node.js.map +1 -0
  30. package/dist/nodes/PublerLocations/PublerLocations.spec.d.ts +1 -0
  31. package/dist/nodes/PublerLocations/PublerLocations.spec.js +8 -0
  32. package/dist/nodes/PublerLocations/PublerLocations.spec.js.map +1 -0
  33. package/dist/nodes/PublerLocations/logo.svg +44 -0
  34. package/dist/nodes/PublerLocations/openapi.json +205 -0
  35. package/dist/nodes/PublerMedia/PublerMedia.node.d.ts +4 -0
  36. package/dist/nodes/{Publer/Publer.node.js → PublerMedia/PublerMedia.node.js} +8 -8
  37. package/dist/nodes/PublerMedia/PublerMedia.node.js.map +1 -0
  38. package/dist/nodes/PublerMedia/PublerMedia.spec.d.ts +1 -0
  39. package/dist/nodes/PublerMedia/PublerMedia.spec.js +8 -0
  40. package/dist/nodes/PublerMedia/PublerMedia.spec.js.map +1 -0
  41. package/dist/nodes/PublerMedia/logo.svg +44 -0
  42. package/dist/nodes/PublerMedia/openapi.json +346 -0
  43. package/dist/nodes/PublerPosts/PublerPosts.node.d.ts +4 -0
  44. package/dist/nodes/PublerPosts/PublerPosts.node.js +75 -0
  45. package/dist/nodes/PublerPosts/PublerPosts.node.js.map +1 -0
  46. package/dist/nodes/PublerPosts/PublerPosts.spec.d.ts +1 -0
  47. package/dist/nodes/PublerPosts/PublerPosts.spec.js +8 -0
  48. package/dist/nodes/PublerPosts/PublerPosts.spec.js.map +1 -0
  49. package/dist/nodes/PublerPosts/logo.svg +44 -0
  50. package/dist/nodes/PublerPosts/openapi.json +536 -0
  51. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.node.d.ts +4 -0
  52. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.node.js +75 -0
  53. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.node.js.map +1 -0
  54. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.spec.d.ts +1 -0
  55. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.spec.js +8 -0
  56. package/dist/nodes/PublerPostsPublish/PublerPostsPublish.spec.js.map +1 -0
  57. package/dist/nodes/PublerPostsPublish/logo.svg +44 -0
  58. package/dist/nodes/PublerPostsPublish/openapi.json +229 -0
  59. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.node.d.ts +4 -0
  60. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.node.js +75 -0
  61. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.node.js.map +1 -0
  62. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.spec.d.ts +1 -0
  63. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.spec.js +8 -0
  64. package/dist/nodes/PublerPostsSchedule/PublerPostsSchedule.spec.js.map +1 -0
  65. package/dist/nodes/PublerPostsSchedule/logo.svg +44 -0
  66. package/dist/nodes/PublerPostsSchedule/openapi.json +235 -0
  67. package/dist/package.json +27 -6
  68. package/package.json +27 -6
  69. package/dist/nodes/Publer/Publer.node.js.map +0 -1
  70. package/dist/nodes/Publer/Publer.node.json +0 -18
  71. package/dist/nodes/Publer/Publer.spec.js +0 -8
  72. package/dist/nodes/Publer/Publer.spec.js.map +0 -1
  73. package/dist/nodes/Publer/logo.svg +0 -1
  74. package/dist/nodes/Publer/openapi.json +0 -1527
  75. /package/dist/nodes/{Publer/Publer.spec.d.ts → PublerAnalytics/PublerAnalytics.spec.d.ts} +0 -0
package/dist/nodes/Publer/openapi.json DELETED
@@ -1,1527 +0,0 @@
1
- {
2
- "openapi": "3.0.0",
3
- "info": {
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 ...\n",
6
- "version": "1.0.0"
7
- },
8
- "servers": [
9
- {
10
- "url": "https://app.publer.com/api/v1"
11
- }
12
- ],
13
- "security": [
14
- {
15
- "bearerAuth": []
16
- }
17
- ],
18
- "tags": [
19
- {
20
- "name": "USERS"
21
- },
22
- {
23
- "name": "WORKSPACES"
24
- },
25
- {
26
- "name": "ACCOUNTS"
27
- },
28
- {
29
- "name": "MEDIA"
30
- },
31
- {
32
- "name": "POSTS"
33
- },
34
- {
35
- "name": "POSTS > PUBLISHING METHODS"
36
- },
37
- {
38
- "name": "POSTS > PUBLISHING METHODS > DRAFTS"
39
- },
40
- {
41
- "name": "POSTS > PUBLISHING METHODS > AUTO SCHEDULE"
42
- },
43
- {
44
- "name": "POSTS > CONTENT TYPES"
45
- },
46
- {
47
- "name": "POSTS > CONTENT TYPES > NETWORK-SPECIFIK TYPES"
48
- },
49
- {
50
- "name": "JOB STATUS"
51
- },
52
- {
53
- "name": "LOCATIONS"
54
- },
55
- {
56
- "name": "ANALYTICS"
57
- }
58
- ],
59
- "paths": {
60
- "/users/me": {
61
- "get": {
62
- "tags": [
63
- "USERS"
64
- ],
65
- "summary": "Me",
66
- "responses": {
67
- "200": {
68
- "description": "Successful response",
69
- "content": {
70
- "application/json": {}
71
- }
72
- }
73
- }
74
- }
75
- },
76
- "/workspaces": {
77
- "get": {
78
- "tags": [
79
- "WORKSPACES"
80
- ],
81
- "summary": "Fetch workspaces",
82
- "responses": {
83
- "200": {
84
- "description": "Successful response",
85
- "content": {
86
- "application/json": {}
87
- }
88
- }
89
- }
90
- }
91
- },
92
- "/workspaces/{workspace_id}/signatures": {
93
- "get": {
94
- "tags": [
95
- "WORKSPACES"
96
- ],
97
- "summary": "Fetch signatures",
98
- "parameters": [
99
- {
100
- "name": "accounts[]",
101
- "in": "query",
102
- "schema": {
103
- "type": "string"
104
- },
105
- "example": "647a0edddb2797b89044e2c1"
106
- },
107
- {
108
- "name": "workspace_id",
109
- "in": "path",
110
- "schema": {
111
- "type": "string"
112
- },
113
- "required": true
114
- }
115
- ],
116
- "responses": {
117
- "200": {
118
- "description": "Successful response",
119
- "content": {
120
- "application/json": {}
121
- }
122
- }
123
- }
124
- }
125
- },
126
- "/workspaces/{workspace_id}/media_options": {
127
- "get": {
128
- "tags": [
129
- "WORKSPACES"
130
- ],
131
- "summary": "Fetch media options",
132
- "parameters": [
133
- {
134
- "name": "accounts[]",
135
- "in": "query",
136
- "schema": {
137
- "type": "string"
138
- },
139
- "example": "661ce240db2797a7148a6b49"
140
- },
141
- {
142
- "name": "workspace_id",
143
- "in": "path",
144
- "schema": {
145
- "type": "string"
146
- },
147
- "required": true
148
- }
149
- ],
150
- "responses": {
151
- "200": {
152
- "description": "Successful response",
153
- "content": {
154
- "application/json": {}
155
- }
156
- }
157
- }
158
- }
159
- },
160
- "/accounts": {
161
- "get": {
162
- "tags": [
163
- "ACCOUNTS"
164
- ],
165
- "summary": "List Accounts",
166
- "parameters": [
167
- {
168
- "name": "Publer-Workspace-Id",
169
- "in": "header",
170
- "schema": {
171
- "type": "string"
172
- },
173
- "example": "{{workspace_id}}",
174
- "required": true
175
- }
176
- ],
177
- "responses": {
178
- "200": {
179
- "description": "Successful response",
180
- "content": {
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
- }
194
- }
195
- }
196
- }
197
- }
198
- },
199
- "/media": {
200
- "get": {
201
- "tags": [
202
- "MEDIA"
203
- ],
204
- "summary": "List media",
205
- "parameters": [
206
- {
207
- "name": "Publer-Workspace-Id",
208
- "in": "header",
209
- "schema": {
210
- "type": "string"
211
- },
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
233
- },
234
- {
235
- "name": "types[]",
236
- "in": "query",
237
- "schema": {
238
- "type": "array",
239
- "items": {
240
- "type": "string",
241
- "enum": ["photo", "video", "gif"]
242
- }
243
- },
244
- "example": ["photo"]
245
- },
246
- {
247
- "name": "used[]",
248
- "in": "query",
249
- "schema": {
250
- "type": "array",
251
- "items": {
252
- "type": "boolean"
253
- }
254
- },
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
- }
274
- }
275
- ],
276
- "responses": {
277
- "200": {
278
- "description": "Successful response",
279
- "content": {
280
- "application/json": {}
281
- }
282
- }
283
- }
284
- },
285
- "post": {
286
- "tags": [
287
- "MEDIA"
288
- ],
289
- "summary": "Upload file",
290
- "requestBody": {
291
- "content": {
292
- "multipart/form-data": {
293
- "schema": {
294
- "type": "object",
295
- "properties": {
296
- "file": {
297
- "type": "string",
298
- "format": "binary"
299
- },
300
- "direct_upload": {
301
- "type": "boolean",
302
- "example": false
303
- },
304
- "in_library": {
305
- "type": "boolean",
306
- "example": true
307
- }
308
- }
309
- }
310
- }
311
- }
312
- },
313
- "parameters": [
314
- {
315
- "name": "Publer-Workspace-Id",
316
- "in": "header",
317
- "schema": {
318
- "type": "string"
319
- },
320
- "example": "{{workspace_id}}",
321
- "required": true
322
- }
323
- ],
324
- "responses": {
325
- "200": {
326
- "description": "Successful response",
327
- "content": {
328
- "application/json": {}
329
- }
330
- }
331
- }
332
- }
333
- },
334
- "/media/from-url": {
335
- "post": {
336
- "tags": [
337
- "MEDIA"
338
- ],
339
- "summary": "Upload from url",
340
- "requestBody": {
341
- "content": {
342
- "application/json": {
343
- "schema": {
344
- "type": "object",
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
- }
371
- }
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
- }
391
- }
392
- }
393
- }
394
- }
395
- },
396
- "parameters": [
397
- {
398
- "name": "Publer-Workspace-Id",
399
- "in": "header",
400
- "schema": {
401
- "type": "string"
402
- },
403
- "example": "{{workspace_id}}",
404
- "required": true
405
- }
406
- ],
407
- "responses": {
408
- "200": {
409
- "description": "Successful response",
410
- "content": {
411
- "application/json": {}
412
- }
413
- }
414
- }
415
- }
416
- },
417
- "/posts/schedule": {
418
- "post": {
419
- "tags": [
420
- "POSTS > CONTENT TYPES"
421
- ],
422
- "summary": "Schedule post",
423
- "description": "Schedule a post. Supports text, photo, video, link, carousel, story, reel, and gif content types.",
424
- "requestBody": {
425
- "content": {
426
- "application/json": {
427
- "schema": {
428
- "type": "object",
429
- "required": ["bulk"],
430
- "properties": {
431
- "bulk": {
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
- }
533
- }
534
- }
535
- }
536
- }
537
- }
538
- }
539
- }
540
- }
541
- }
542
- }
543
- },
544
- "parameters": [
545
- {
546
- "name": "Publer-Workspace-Id",
547
- "in": "header",
548
- "schema": {
549
- "type": "string"
550
- },
551
- "example": "{{workspace_id}}",
552
- "required": true
553
- }
554
- ],
555
- "responses": {
556
- "200": {
557
- "description": "Successful response",
558
- "content": {
559
- "application/json": {}
560
- }
561
- }
562
- }
563
- }
564
- },
565
- "/posts/schedule/publish": {
566
- "post": {
567
- "tags": [
568
- "POSTS > PUBLISHING METHODS"
569
- ],
570
- "summary": "Publish immediately",
571
- "description": "Publish a post immediately. Supports text, photo, video, link, carousel, story, reel, and gif content types.",
572
- "requestBody": {
573
- "content": {
574
- "application/json": {
575
- "schema": {
576
- "type": "object",
577
- "required": ["bulk"],
578
- "properties": {
579
- "bulk": {
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
- }
664
- }
665
- }
666
- }
667
- }
668
- }
669
- }
670
- }
671
- }
672
- }
673
- },
674
- "parameters": [
675
- {
676
- "name": "Publer-Workspace-Id",
677
- "in": "header",
678
- "schema": {
679
- "type": "string"
680
- },
681
- "example": "{{workspace_id}}",
682
- "required": true
683
- }
684
- ],
685
- "responses": {
686
- "200": {
687
- "description": "Successful response",
688
- "content": {
689
- "application/json": {}
690
- }
691
- }
692
- }
693
- }
694
- },
695
- "/posts": {
696
- "get": {
697
- "tags": [
698
- "POSTS"
699
- ],
700
- "summary": "List Posts",
701
- "parameters": [
702
- {
703
- "name": "Publer-Workspace-Id",
704
- "in": "header",
705
- "schema": {
706
- "type": "string"
707
- },
708
- "example": "{{workspace_id}}",
709
- "required": true
710
- },
711
- {
712
- "name": "state",
713
- "in": "query",
714
- "schema": {
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"]
717
- },
718
- "example": "scheduled"
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
- },
749
- {
750
- "name": "page",
751
- "in": "query",
752
- "schema": {
753
- "type": "integer"
754
- },
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
- }
789
- }
790
- ],
791
- "responses": {
792
- "200": {
793
- "description": "Successful response",
794
- "content": {
795
- "application/json": {}
796
- }
797
- }
798
- }
799
- },
800
- "delete": {
801
- "tags": [
802
- "POSTS"
803
- ],
804
- "summary": "Delete posts",
805
- "parameters": [
806
- {
807
- "name": "Publer-Workspace-Id",
808
- "in": "header",
809
- "schema": {
810
- "type": "string"
811
- },
812
- "example": "{{workspace_id}}",
813
- "required": true
814
- },
815
- {
816
- "name": "post_ids[]",
817
- "in": "query",
818
- "schema": {
819
- "type": "array",
820
- "items": {
821
- "type": "string"
822
- }
823
- },
824
- "example": ["684945796a88bf9baa9c182c"]
825
- }
826
- ],
827
- "responses": {
828
- "200": {
829
- "description": "Successful response",
830
- "content": {
831
- "application/json": {}
832
- }
833
- }
834
- }
835
- }
836
- },
837
- "/posts/links": {
838
- "post": {
839
- "tags": [
840
- "POSTS"
841
- ],
842
- "summary": "Extract link metadata",
843
- "requestBody": {
844
- "content": {
845
- "application/json": {
846
- "schema": {
847
- "type": "object",
848
- "example": {
849
- "url": "publer.com"
850
- }
851
- }
852
- }
853
- }
854
- },
855
- "responses": {
856
- "200": {
857
- "description": "Successful response",
858
- "content": {
859
- "application/json": {}
860
- }
861
- }
862
- }
863
- }
864
- },
865
- "/posts/{post_id}": {
866
- "put": {
867
- "tags": [
868
- "POSTS"
869
- ],
870
- "summary": "Update post",
871
- "parameters": [
872
- {
873
- "name": "post_id",
874
- "in": "path",
875
- "schema": {
876
- "type": "string"
877
- },
878
- "required": true
879
- },
880
- {
881
- "name": "Publer-Workspace-Id",
882
- "in": "header",
883
- "schema": {
884
- "type": "string"
885
- },
886
- "example": "{{workspace_id}}",
887
- "required": true
888
- }
889
- ],
890
- "responses": {
891
- "200": {
892
- "description": "Successful response",
893
- "content": {
894
- "application/json": {}
895
- }
896
- }
897
- }
898
- }
899
- },
900
- "/job_status/{job_id}": {
901
- "get": {
902
- "tags": [
903
- "JOB STATUS"
904
- ],
905
- "summary": "Job status",
906
- "parameters": [
907
- {
908
- "name": "job_id",
909
- "in": "path",
910
- "schema": {
911
- "type": "string"
912
- },
913
- "required": true
914
- },
915
- {
916
- "name": "Publer-Workspace-Id",
917
- "in": "header",
918
- "schema": {
919
- "type": "string"
920
- },
921
- "example": "{{workspace_id}}",
922
- "required": true
923
- }
924
- ],
925
- "responses": {
926
- "200": {
927
- "description": "Successful response",
928
- "content": {
929
- "application/json": {}
930
- }
931
- }
932
- }
933
- }
934
- },
935
- "/locations/instagram": {
936
- "get": {
937
- "tags": [
938
- "LOCATIONS"
939
- ],
940
- "summary": "Instagram locations",
941
- "parameters": [
942
- {
943
- "name": "Publer-Workspace-Id",
944
- "in": "header",
945
- "schema": {
946
- "type": "string"
947
- },
948
- "example": "{{workspace_id}}",
949
- "required": true
950
- },
951
- {
952
- "name": "q",
953
- "in": "query",
954
- "schema": {
955
- "type": "string"
956
- },
957
- "example": "Tirana"
958
- }
959
- ],
960
- "responses": {
961
- "200": {
962
- "description": "Successful response",
963
- "content": {
964
- "application/json": {}
965
- }
966
- }
967
- }
968
- }
969
- },
970
- "/locations/facebook": {
971
- "get": {
972
- "tags": [
973
- "LOCATIONS"
974
- ],
975
- "summary": "Facebook locations",
976
- "parameters": [
977
- {
978
- "name": "Publer-Workspace-Id",
979
- "in": "header",
980
- "schema": {
981
- "type": "string"
982
- },
983
- "example": "{{workspace_id}}",
984
- "required": true
985
- },
986
- {
987
- "name": "q",
988
- "in": "query",
989
- "schema": {
990
- "type": "string"
991
- },
992
- "example": "Tirana"
993
- }
994
- ],
995
- "responses": {
996
- "200": {
997
- "description": "Successful response",
998
- "content": {
999
- "application/json": {}
1000
- }
1001
- }
1002
- }
1003
- }
1004
- },
1005
- "/locations/threads": {
1006
- "get": {
1007
- "tags": [
1008
- "LOCATIONS"
1009
- ],
1010
- "summary": "Threads locations",
1011
- "parameters": [
1012
- {
1013
- "name": "Publer-Workspace-Id",
1014
- "in": "header",
1015
- "schema": {
1016
- "type": "string"
1017
- },
1018
- "example": "{{workspace_id}}",
1019
- "required": true
1020
- },
1021
- {
1022
- "name": "q",
1023
- "in": "query",
1024
- "schema": {
1025
- "type": "string"
1026
- },
1027
- "example": "Tirana"
1028
- }
1029
- ],
1030
- "responses": {
1031
- "200": {
1032
- "description": "Successful response",
1033
- "content": {
1034
- "application/json": {}
1035
- }
1036
- }
1037
- }
1038
- }
1039
- },
1040
- "/analytics/charts": {
1041
- "get": {
1042
- "tags": [
1043
- "ANALYTICS"
1044
- ],
1045
- "summary": "Get charts",
1046
- "parameters": [
1047
- {
1048
- "name": "Publer-Workspace-Id",
1049
- "in": "header",
1050
- "schema": {
1051
- "type": "string"
1052
- },
1053
- "example": "{{workspace_id}}",
1054
- "required": true
1055
- }
1056
- ],
1057
- "responses": {
1058
- "200": {
1059
- "description": "Successful response",
1060
- "content": {
1061
- "application/json": {}
1062
- }
1063
- }
1064
- }
1065
- }
1066
- },
1067
- "/analytics/{account_id}/chart_data": {
1068
- "get": {
1069
- "tags": [
1070
- "ANALYTICS"
1071
- ],
1072
- "summary": "Charts data",
1073
- "parameters": [
1074
- {
1075
- "name": "Publer-Workspace-Id",
1076
- "in": "header",
1077
- "schema": {
1078
- "type": "string"
1079
- },
1080
- "example": "{{workspace_id}}",
1081
- "required": true
1082
- },
1083
- {
1084
- "name": "from",
1085
- "in": "query",
1086
- "schema": {
1087
- "type": "string"
1088
- },
1089
- "example": "2025-03-21"
1090
- },
1091
- {
1092
- "name": "to",
1093
- "in": "query",
1094
- "schema": {
1095
- "type": "string"
1096
- },
1097
- "example": "2025-08-18"
1098
- },
1099
- {
1100
- "name": "chart_ids[]",
1101
- "in": "query",
1102
- "schema": {
1103
- "type": "array",
1104
- "items": {
1105
- "type": "string"
1106
- }
1107
- },
1108
- "example": ["followers"]
1109
- },
1110
- {
1111
- "name": "account_id",
1112
- "in": "path",
1113
- "schema": {
1114
- "type": "string"
1115
- },
1116
- "required": true
1117
- }
1118
- ],
1119
- "responses": {
1120
- "200": {
1121
- "description": "Successful response",
1122
- "content": {
1123
- "application/json": {}
1124
- }
1125
- }
1126
- }
1127
- }
1128
- },
1129
- "/analytics/{account_id}/post_insights": {
1130
- "get": {
1131
- "tags": [
1132
- "ANALYTICS"
1133
- ],
1134
- "summary": "Post insights",
1135
- "parameters": [
1136
- {
1137
- "name": "Publer-Workspace-Id",
1138
- "in": "header",
1139
- "schema": {
1140
- "type": "string"
1141
- },
1142
- "example": "{{workspace_id}}",
1143
- "required": true
1144
- },
1145
- {
1146
- "name": "from",
1147
- "in": "query",
1148
- "schema": {
1149
- "type": "string"
1150
- },
1151
- "example": "2025-05-13"
1152
- },
1153
- {
1154
- "name": "to",
1155
- "in": "query",
1156
- "schema": {
1157
- "type": "string"
1158
- },
1159
- "example": "2025-08-10"
1160
- },
1161
- {
1162
- "name": "page",
1163
- "in": "query",
1164
- "schema": {
1165
- "type": "integer"
1166
- },
1167
- "example": 0
1168
- },
1169
- {
1170
- "name": "account_id",
1171
- "in": "path",
1172
- "schema": {
1173
- "type": "string"
1174
- },
1175
- "required": true
1176
- }
1177
- ],
1178
- "responses": {
1179
- "200": {
1180
- "description": "Successful response",
1181
- "content": {
1182
- "application/json": {}
1183
- }
1184
- }
1185
- }
1186
- }
1187
- },
1188
- "/analytics/{account_id}/hashtag_insights": {
1189
- "get": {
1190
- "tags": [
1191
- "ANALYTICS"
1192
- ],
1193
- "summary": "Hashtag insights",
1194
- "parameters": [
1195
- {
1196
- "name": "Publer-Workspace-Id",
1197
- "in": "header",
1198
- "schema": {
1199
- "type": "string"
1200
- },
1201
- "example": "{{workspace_id}}",
1202
- "required": true
1203
- },
1204
- {
1205
- "name": "from",
1206
- "in": "query",
1207
- "schema": {
1208
- "type": "string"
1209
- },
1210
- "example": "2025-07-15"
1211
- },
1212
- {
1213
- "name": "to",
1214
- "in": "query",
1215
- "schema": {
1216
- "type": "string"
1217
- },
1218
- "example": "2025-08-11"
1219
- },
1220
- {
1221
- "name": "account_id",
1222
- "in": "path",
1223
- "schema": {
1224
- "type": "string"
1225
- },
1226
- "required": true
1227
- }
1228
- ],
1229
- "responses": {
1230
- "200": {
1231
- "description": "Successful response",
1232
- "content": {
1233
- "application/json": {}
1234
- }
1235
- }
1236
- }
1237
- }
1238
- },
1239
- "/analytics/{account_id}/hashtag_performing_posts": {
1240
- "get": {
1241
- "tags": [
1242
- "ANALYTICS"
1243
- ],
1244
- "summary": "Hashtag performing posts",
1245
- "parameters": [
1246
- {
1247
- "name": "Publer-Workspace-Id",
1248
- "in": "header",
1249
- "schema": {
1250
- "type": "string"
1251
- },
1252
- "example": "{{workspace_id}}",
1253
- "required": true
1254
- },
1255
- {
1256
- "name": "hashtag",
1257
- "in": "query",
1258
- "schema": {
1259
- "type": "string"
1260
- },
1261
- "description": "#smm",
1262
- "example": "%23smm"
1263
- },
1264
- {
1265
- "name": "from",
1266
- "in": "query",
1267
- "schema": {
1268
- "type": "string"
1269
- },
1270
- "example": "2025-01-31"
1271
- },
1272
- {
1273
- "name": "to",
1274
- "in": "query",
1275
- "schema": {
1276
- "type": "string"
1277
- },
1278
- "example": "2025-12-31"
1279
- },
1280
- {
1281
- "name": "account_id",
1282
- "in": "path",
1283
- "schema": {
1284
- "type": "string"
1285
- },
1286
- "required": true
1287
- }
1288
- ],
1289
- "responses": {
1290
- "200": {
1291
- "description": "Successful response",
1292
- "content": {
1293
- "application/json": {}
1294
- }
1295
- }
1296
- }
1297
- }
1298
- },
1299
- "/analytics/{account_id}/best_times": {
1300
- "get": {
1301
- "tags": [
1302
- "ANALYTICS"
1303
- ],
1304
- "summary": "Best times to post",
1305
- "parameters": [
1306
- {
1307
- "name": "Publer-Workspace-Id",
1308
- "in": "header",
1309
- "schema": {
1310
- "type": "string"
1311
- },
1312
- "example": "{{workspace_id}}",
1313
- "required": true
1314
- },
1315
- {
1316
- "name": "from",
1317
- "in": "query",
1318
- "schema": {
1319
- "type": "string"
1320
- },
1321
- "example": "2024-01-01"
1322
- },
1323
- {
1324
- "name": "to",
1325
- "in": "query",
1326
- "schema": {
1327
- "type": "string"
1328
- },
1329
- "example": "2024-12-31"
1330
- },
1331
- {
1332
- "name": "account_id",
1333
- "in": "path",
1334
- "schema": {
1335
- "type": "string"
1336
- },
1337
- "required": true
1338
- }
1339
- ],
1340
- "responses": {
1341
- "200": {
1342
- "description": "Successful response",
1343
- "content": {
1344
- "application/json": {}
1345
- }
1346
- }
1347
- }
1348
- }
1349
- },
1350
- "/analytics/members": {
1351
- "get": {
1352
- "tags": [
1353
- "ANALYTICS"
1354
- ],
1355
- "summary": "Members",
1356
- "parameters": [
1357
- {
1358
- "name": "Publer-Workspace-Id",
1359
- "in": "header",
1360
- "schema": {
1361
- "type": "string"
1362
- },
1363
- "example": "{{workspace_id}}",
1364
- "required": true
1365
- },
1366
- {
1367
- "name": "from",
1368
- "in": "query",
1369
- "schema": {
1370
- "type": "string"
1371
- },
1372
- "example": "2025-07-16"
1373
- },
1374
- {
1375
- "name": "to",
1376
- "in": "query",
1377
- "schema": {
1378
- "type": "string"
1379
- },
1380
- "example": "2025-08-12"
1381
- }
1382
- ],
1383
- "responses": {
1384
- "200": {
1385
- "description": "Successful response",
1386
- "content": {
1387
- "application/json": {}
1388
- }
1389
- }
1390
- }
1391
- }
1392
- },
1393
- "/competitors": {
1394
- "get": {
1395
- "tags": [
1396
- "ANALYTICS"
1397
- ],
1398
- "summary": "Competitors",
1399
- "parameters": [
1400
- {
1401
- "name": "Publer-Workspace-Id",
1402
- "in": "header",
1403
- "schema": {
1404
- "type": "string"
1405
- },
1406
- "example": "{{workspace_id}}",
1407
- "required": true
1408
- }
1409
- ],
1410
- "responses": {
1411
- "200": {
1412
- "description": "Successful response",
1413
- "content": {
1414
- "application/json": {}
1415
- }
1416
- }
1417
- }
1418
- }
1419
- },
1420
- "/competitors/{competitor_id}/analytics": {
1421
- "get": {
1422
- "tags": [
1423
- "ANALYTICS"
1424
- ],
1425
- "summary": "Competitors analytics",
1426
- "parameters": [
1427
- {
1428
- "name": "competitor_id",
1429
- "in": "path",
1430
- "schema": {
1431
- "type": "string"
1432
- },
1433
- "required": true
1434
- },
1435
- {
1436
- "name": "Publer-Workspace-Id",
1437
- "in": "header",
1438
- "schema": {
1439
- "type": "string"
1440
- },
1441
- "example": "{{workspace_id}}",
1442
- "required": true
1443
- },
1444
- {
1445
- "name": "from",
1446
- "in": "query",
1447
- "schema": {
1448
- "type": "string"
1449
- },
1450
- "example": "2025-07-16"
1451
- },
1452
- {
1453
- "name": "to",
1454
- "in": "query",
1455
- "schema": {
1456
- "type": "string"
1457
- },
1458
- "example": "2025-08-12"
1459
- },
1460
- {
1461
- "name": "page",
1462
- "in": "query",
1463
- "schema": {
1464
- "type": "integer"
1465
- },
1466
- "example": 0
1467
- }
1468
- ],
1469
- "responses": {
1470
- "200": {
1471
- "description": "Successful response",
1472
- "content": {
1473
- "application/json": {}
1474
- }
1475
- }
1476
- }
1477
- }
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
- }
1526
- }
1527
- }