Endpoints
Every endpoint of the Buzzmark REST API, with its method and path, the key scope it needs, its inputs and a curl example to copy into code, n8n or Make.
This page and the OpenAPI 3.1 file are built from the definitions the API runs on, so both always match it.
OpenAPI file
Import the OpenAPI 3.1 file into Postman, Insomnia or any tool that reads OpenAPI, or generate a client from it.
Every endpoint
Who the key acts as
GET /api/v1/meThe member the key acts as, their role, the organization's plan, what the key can do and its rate limit. A key acts with its maker's role of today: a contributor's key can write drafts but not schedule.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/me" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
List social sets
GET /api/v1/social-setsEvery social set the key's maker can open: its connected accounts, its brand profile, its time zone and its weekly posting slots. Most other endpoints take a social_set_id and account ids from here.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/social-sets" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
List connected accounts
GET /api/v1/channelsEvery social account in the key's social sets, once each, with the sets it belongs to. An account that isn't connected can't take a post until it is reconnected in Buzzmark.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/channels" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
List brand profiles
GET /api/v1/brand-profilesThe brand profiles (Hive profiles) the key's maker can open: what Buzzmark knows about each brand and its voice. Pass an id as hive_profile_id when a draft is written for another brand than its set's own.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/brand-profiles" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Best times to post
GET /api/v1/best-timesWhen a social set's own published posts did best, weekday and hour on the set's clock. LinkedIn's numbers stay in Buzzmark: schedule with when "best_time" to use them.
Needs a key that reads.
Query
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
daysOptional- number, 14 to 180. How many days of published posts to read, counted back from now. 14 to 180, default 90.
Example
curl -X GET "https://buzzmark.ai/api/v1/best-times?social_set_id=12&days=90" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Create a draft
POST /api/v1/draftsSaves a draft in a social set. Nothing is posted or scheduled. The answer lists what a platform would refuse, so it can be fixed before scheduling.
Needs a key that drafts. Send an Idempotency-Key header.
Body
textOptional- text, up to 10,000 characters. The words of a single post. Use thread instead for several.
threadOptional- list of text, up to 25. A thread: one string per post. Replaces text.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile the draft is written for, id from list_brand_profiles. Default: the social set's own.
account_idsOptional- list of number, up to 20. Accounts it goes to, first one leading. Default: the set's default accounts.
first_commentOptional- text, up to 5,000 characters. A comment posted under the post right after it goes out, on LinkedIn, Instagram (not a story), Facebook and Threads; other platforms leave it out. At most 500 characters on Threads, 1,250 on LinkedIn, 2,200 on Instagram, 5,000 on Facebook. An empty string removes it; leave it out to keep the draft's comment as it is.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
Example
curl -X POST "https://buzzmark.ai/api/v1/drafts" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"social_set_id":12,"text":"Our spring menu is in. Seven new dishes, all from farms within 50 km."}'Update a draft
PATCH /api/v1/drafts/{id}Changes a draft's text, accounts, first comment or campaign. A field left out keeps what the draft has; pictures stay on their posts when only the words change.
Needs a key that drafts.
Body
textOptional- text, up to 10,000 characters. The words of a single post. Use thread instead for several.
threadOptional- list of text, up to 25. A thread: one string per post. Replaces text.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile the draft is written for, id from list_brand_profiles. Default: the social set's own.
account_idsOptional- list of number, up to 20. Accounts it goes to, first one leading. Default: the set's default accounts.
first_commentOptional- text, up to 5,000 characters. A comment posted under the post right after it goes out, on LinkedIn, Instagram (not a story), Facebook and Threads; other platforms leave it out. At most 500 characters on Threads, 1,250 on LinkedIn, 2,200 on Instagram, 5,000 on Facebook. An empty string removes it; leave it out to keep the draft's comment as it is.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
Example
curl -X PATCH "https://buzzmark.ai/api/v1/drafts/401" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Our spring menu is in. Seven new dishes, all from farms within 50 km of the kitchen."}'Delete a draft
DELETE /api/v1/drafts/{id}Deletes a draft for good. A scheduled post is taken back to drafts with unschedule first.
Needs a key that drafts.
Example
curl -X DELETE "https://buzzmark.ai/api/v1/drafts/401" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
List posts
GET /api/v1/postsBuzzes newest first, a page at a time: drafts, scheduled, published or failed. Filter by status, social set and the scheduled time. Text is cut to 400 characters; GET /posts/{id} has the whole post.
Needs a key that reads.
Query
statusOptional- one of "draft", "scheduled", "published", "failed", "all". Which posts: "draft", "scheduled", "published", "failed", or "all" (default). Default "all".
social_set_idOptional- number. Only this social set's posts, id from list_social_sets. Leave out for every set.
fromOptional- text. Only posts scheduled at or after this time, ISO 8601. Drafts have no time, so they drop out.
toOptional- text. Only posts scheduled before this time, ISO 8601.
limitOptional- number, 1 to 50. How many posts, 1 to 50, default 20.
cursorOptional- text. next_cursor from the page before.
Example
curl -X GET "https://buzzmark.ai/api/v1/posts?status=scheduled&limit=20" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Get a post
GET /api/v1/posts/{id}One Buzz in full, with what each platform did with it once it was sent (its live link, or why it was refused) and what this key can do to it now.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/posts/401" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Schedule a post
POST /api/v1/postsSchedules a draft (post_id), or a new post written here (text or thread, and its set), at a time, at the best time or in the set's next free slot. Nothing posts right away. The post is checked first with the same rules as POST /posts/validate: a post that would be BLOCKED answers 422 with the report, and nothing is saved. A time without an offset is on the social set's clock.
Needs a key that schedules. An owner's or an editor's key: a contributor's key can't. Send an Idempotency-Key header.
Body
whenRequired- text. "best_time" (Buzzmark picks the soonest free best time for these accounts), "next_slot", or a date and time: "2026-10-02T09:00" on the set's clock, or ISO 8601 with an offset.
account_idsOptional- list of number, up to 20. Default: the accounts saved on the draft, else the set's default accounts.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
pinterestOptional- object. Only for a draft that goes to Pinterest: its board, title and link.
post_idOptional- number. A draft to schedule. Leave it out to schedule a new post from text or thread.
textOptional- text, up to 10,000 characters. The words of a single post. Use thread instead for several.
threadOptional- list of text, up to 25. A thread: one string per post. Replaces text.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile the draft is written for, id from list_brand_profiles. Default: the social set's own.
first_commentOptional- text, up to 5,000 characters. A comment posted under the post right after it goes out, on LinkedIn, Instagram (not a story), Facebook and Threads; other platforms leave it out. At most 500 characters on Threads, 1,250 on LinkedIn, 2,200 on Instagram, 5,000 on Facebook. An empty string removes it; leave it out to keep the draft's comment as it is.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"social_set_id":12,"text":"Doors open at 7 tonight. First 20 guests get the tasting menu at half price.","when":"next_slot"}'Check a post without saving it
POST /api/v1/posts/validateA dry run: READY, WARNING or BLOCKED for each account, with the reasons. It blocks exactly what Buzzmark's composer blocks, and creates nothing.
Needs a key that reads.
Body
whenOptional- text. Optional. With a date and time, the check also counts the accounts' other posts that day and that minute. "best_time" and "next_slot" pick a free time, so they are never refused for it.
account_idsOptional- list of number, up to 20. Default: the accounts saved on the draft, else the set's default accounts.
campaign_idOptional- number. Optional. The campaign this post belongs to, from list_campaigns. It must be a campaign of the same social set. 0 takes the post out of its campaign; leave it out to keep what the post has.
pinterestOptional- object. Only for a draft that goes to Pinterest: its board, title and link.
post_idOptional- number. A draft to schedule. Leave it out to schedule a new post from text or thread.
textOptional- text, up to 10,000 characters. The words of a single post. Use thread instead for several.
threadOptional- list of text, up to 25. A thread: one string per post. Replaces text.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile the draft is written for, id from list_brand_profiles. Default: the social set's own.
first_commentOptional- text, up to 5,000 characters. A comment posted under the post right after it goes out, on LinkedIn, Instagram (not a story), Facebook and Threads; other platforms leave it out. At most 500 characters on Threads, 1,250 on LinkedIn, 2,200 on Instagram, 5,000 on Facebook. An empty string removes it; leave it out to keep the draft's comment as it is.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts/validate" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"social_set_id":12,"account_ids":[31,32],"text":"Doors open at 7 tonight.","when":"2026-12-04T18:00"}'Schedule several posts
POST /api/v1/posts/bulkSchedules up to 25 posts in one request, each shaped like POST /posts. Every post is checked first; when one would be BLOCKED, the answer is 422 with each post's report and nothing is saved. A post to Pinterest is scheduled on its own with POST /posts.
Needs a key that schedules. An owner's or an editor's key: a contributor's key can't. Send an Idempotency-Key header.
Body
postsRequired- list of object, up to 25. 1 to 25 posts.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts/bulk" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"posts":[{"post_id":401,"when":"next_slot"},{"social_set_id":12,"text":"Sunday brunch is back.","when":"2026-12-06T09:30"}]}'Move a scheduled post
POST /api/v1/posts/{id}/rescheduleMoves a scheduled post to a new date and time, kept exactly. The words, pictures and accounts stay as they are.
Needs a key that schedules. An owner's or an editor's key: a contributor's key can't.
Body
whenRequired- text. A date and time: "2026-10-02T09:00" on the set's clock, or ISO 8601 with an offset.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts/401/reschedule" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"when":"2026-12-05T08:00"}'Take a post off the schedule
POST /api/v1/posts/{id}/unscheduleTakes a scheduled post back to the drafts, with its text, pictures and accounts. Nothing is deleted.
Needs a key that schedules. An owner's or an editor's key: a contributor's key can't.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts/401/unschedule" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Send a failed post again
POST /api/v1/posts/{id}/retrySends a failed or partly sent post again, only to the platforms that refused it. A post whose outcome was never confirmed is never sent again here: check the account first, then reschedule it in Buzzmark.
Needs a key that schedules. An owner's or an editor's key: a contributor's key can't.
Example
curl -X POST "https://buzzmark.ai/api/v1/posts/401/retry" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Get an upload link for a file
POST /api/v1/media/upload-urlFor a picture or video your code has as a file. Answers upload_url and upload_id: PUT the file's bytes to upload_url with the Content-Type header the answer gives and nothing else, then send upload_id to POST /media/from-upload. The upload_url works for 55 minutes. Takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB. Alt text isn't taken yet.
Needs a key that drafts. Send an Idempotency-Key header.
Body
file_nameRequired- text, up to 120 characters. The file's name with its ending, like "launch.png". The ending sets its type.
post_idOptional- number. A draft to add the file to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Example
curl -X POST "https://buzzmark.ai/api/v1/media/upload-url" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"file_name":"spring-menu.jpg"}'Keep an uploaded file
POST /api/v1/media/from-uploadAfter the file was PUT to upload_url: Buzzmark copies it into its own storage and the Library, checked like every file in the app, and with post_id adds it to that draft with what a platform would refuse. An upload_id works for 55 minutes.
Needs a key that drafts. Send an Idempotency-Key header.
Body
upload_idRequired- text, up to 2,000 characters. upload_id from create_upload_link.
post_idOptional- number. A draft to add it to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Example
curl -X POST "https://buzzmark.ai/api/v1/media/from-upload" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"upload_id":"<upload_id from POST /media/upload-url>","post_id":401}'Add a picture or video from a link
POST /api/v1/media/from-urlCopies a picture or video from a public https link into Buzzmark's own storage and the Library, and with post_id adds it to that draft with what a platform would refuse. The post never depends on the link staying up. A link to a private or local address, a page instead of a file, or a file over its size is refused and nothing is kept. Takes JPG, PNG, WebP, GIF, MP4 or MOV: pictures up to 10 MB, videos up to 200 MB.
Needs a key that drafts. Send an Idempotency-Key header.
Body
urlRequired- text, up to 2,000 characters. A public https link straight to the file, not to a page that shows it.
post_idOptional- number. A draft to add it to. Without one it goes to the Library only.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Example
curl -X POST "https://buzzmark.ai/api/v1/media/from-url" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/photos/spring-menu.jpg","post_id":401}'Make a picture
POST /api/v1/imagesBuzzmark's image model makes a picture in the brand's colours and keeps it in the Library, marked Made with AI; with post_id it's also added to that draft. A product named exactly as the brand profile lists it brings its own photo as the reference. Uses one of the month's pictures; a refused or failed picture isn't counted. Takes about a minute.
Needs a key that drafts. Send an Idempotency-Key header.
Body
promptRequired- text, up to 3,000 characters. What the picture shows. A photograph by default.
hive_profile_idOptional- number. Brand profile whose colours and products the picture uses, id from list_brand_profiles.
productOptional- text, up to 200 characters. A product name exactly as the Hive profile lists it, to use its photo.
platformsOptional- list of text, up to 8. Where it goes, for the shape (Instagram and Threads 4:5, TikTok 2:3, else square). Default: the draft's platforms.
post_idOptional- number. A draft to add the picture to.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
Example
curl -X POST "https://buzzmark.ai/api/v1/images" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"prompt":"A bowl of spring pea soup on a linen table, morning light","hive_profile_id":7,"post_id":401}'How a post did
GET /api/v1/posts/{id}/statsA published Buzz's numbers on each platform it went to, from the last 180 days: its engagement and each number under the platform's own word (Reposts on X, Upvotes on Reddit). A number a platform doesn't report is left out, never 0. LinkedIn and Pinterest don't allow their numbers to leave Buzzmark, so those platforms are listed with their link and where to see the numbers in Buzzmark, without numbers.
Needs a key that reads.
Example
curl -X GET "https://buzzmark.ai/api/v1/posts/401/stats" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Rank recent posts by engagement
GET /api/v1/analytics/postsA social set's published posts from the last days, best first, with each post's numbers and the numbers summed over the window. A number a platform doesn't report is left out, never 0. LinkedIn and Pinterest posts come apart in numbers_in_buzzmark_only, without numbers and left out of the totals: those platforms don't allow their numbers to leave Buzzmark.
Needs a key that reads.
Query
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
daysOptional- number, 1 to 180. How many days of published posts to read, counted back from now. 1 to 180, default 30.
limitOptional- number, 1 to 30. How many posts to return, best first. 1 to 30, default 10. The totals still count every post in the window.
Example
curl -X GET "https://buzzmark.ai/api/v1/analytics/posts?social_set_id=12&days=30&limit=10" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Write posts in the brand's voice
POST /api/v1/writeBuzz writes 1 to 5 new posts from an idea, in a brand profile's voice, with Buzzmark's writing rules and its after-check, the same as Create in the app. Every answer is kept in the Library. Nothing is saved as a draft: send the text you want to POST /drafts. Each request is one Buzz written for you from the month's allowance; past it, the answer is 429 limit_reached with when it starts again.
Needs a key that drafts. Send an Idempotency-Key header.
Body
ideaRequired- text, up to 2,000 characters. What the posts are about, in the user's words.
hive_profile_idOptional- number. Brand profile whose voice writes the posts, id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set whose Hive profile writes the posts, when hive_profile_id is left out. Optional when the account has one set.
platformOptional- text. Buzzmark platform id (x, linkedin, instagram, threads, facebook, tiktok, bluesky, pinterest, google-business) to write for.
formatOptional- one of "post", "thread". "post" for single posts (default) or "thread" for threads. Default "post".
countOptional- number, 1 to 5. How many posts to write, 1 to 5, default 3.
with_picture_briefOptional- yes or no. Add a brief for a picture to each post, for create_image. Default false.
Example
curl -X POST "https://buzzmark.ai/api/v1/write" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"idea":"Our spring menu launches Friday: seven new dishes from farms within 50 km","platform":"instagram","count":3}'Rewrite a post
POST /api/v1/rewriteBuzz rewrites a post one way and answers up to three versions, in the brand's voice and with Buzzmark's writing rules, as Ask Buzz does in the app. Nothing is saved. Actions: match_hive (sound like the brand), fix_grammar, sharpen, sting (more punch), trim (about half), remix, expand, structure (short lines), warmer, thread_hook, emoji, emoji_bullets, announcement, for_platform (needs platform) and custom (needs instruction).
Needs a key that drafts.
Body
actionRequired- one of "match_hive", "fix_grammar", "sharpen", "sting", "trim", "remix", "expand", "structure", "warmer", "thread_hook", "emoji", "emoji_bullets", "announcement", "for_platform", "custom". How to rewrite it. The tool's description says what each action does.
textOptional- text, up to 10,000 characters. The post to rewrite. Leave out to rewrite a draft's part (post_id, part).
post_idOptional- number. A draft to rewrite instead of text, id from list_posts or save_draft. The draft itself doesn't change.
partOptional- number, 0 to 24. Which post of a thread, from 0. Default 0.
platformOptional- text. Buzzmark platform id. Needed for for_platform; otherwise it sets the length the rewrite keeps to.
instructionOptional- text, up to 600 characters. For custom: how to rewrite it, in the user's words.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
Example
curl -X POST "https://buzzmark.ai/api/v1/rewrite" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"sharpen","text":"We have some new dishes on the menu this spring and we think you'll really like them.","social_set_id":12}'Check a post against the brand voice
POST /api/v1/checkHive check: scores a post 0 to 100 on how much it sounds like the brand, with a verdict, the one thing that works or drifts, and up to three edits, each as the whole post rewritten. Checks text, or a draft (post_id), whose score is kept beside it. Uses one of the month's Hive checks; past them, the answer is 429 limit_reached with when they start again.
Needs a key that drafts.
Body
textOptional- text, up to 10,000 characters. The post to check. Leave out to check the draft named by post_id.
post_idOptional- number. A draft to check instead of text, id from list_posts or save_draft. Its score is kept beside it.
platformOptional- text. Buzzmark platform id the post is for. Default: the draft's first account.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
Example
curl -X POST "https://buzzmark.ai/api/v1/check" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Seven new dishes, all from farms within 50 km. Friday, from 5.","platform":"instagram","social_set_id":12}'Give a draft a version per platform
POST /api/v1/adaptRewrites a draft the way each platform it goes to reads it, and saves those versions on the draft, as Spread does in the app: the draft's first account keeps the post itself, every other platform gets its own text, with the same pictures. A single post, not a thread.
Needs a key that drafts.
Body
post_idRequired- number. The draft's id, from save_draft or list_posts.
platformsOptional- list of text, up to 8. Buzzmark platform ids among the draft's accounts, never the first account's (its text is the post itself). Default: every platform after the first account's.
Example
curl -X POST "https://buzzmark.ai/api/v1/adapt" \
-H "Authorization: Bearer $BUZZMARK_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post_id":401}'Post ideas from the news and competitors
GET /api/v1/ideasScout's latest read for a brand: this week's news in its sector, each topic with why it matters now, its sources and angles to post, plus angles from its competitors when Scout has read them. With refresh=true, or when Scout has never read the news for the brand, it reads again first: up to a minute, one of the month's Scout runs. Needs a key that can write drafts, since it can use Buzz.
Needs a key that drafts.
Query
social_set_idOptional- number. Social set id from list_social_sets. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own.
refreshOptional- one of "true", "false". "true" reads the news again now, as one Scout run. Default "false". Default "false".
Example
curl -X GET "https://buzzmark.ai/api/v1/ideas?social_set_id=12" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
What worked this month
GET /api/v1/insightsWhat a brand's posts from the last 30 days have in common when they do better or worse than its average post, as at most one finding and two moves, each with the number it stands on and an idea to act on. Read at most once a day. LinkedIn and Pinterest findings stay in Buzzmark. Needs a key that can write drafts, since it can use Buzz.
Needs a key that drafts.
Query
social_set_idOptional- number. Social set whose brand profile is read, when hive_profile_id is left out. Optional when the account has one set.
hive_profile_idOptional- number. Brand profile id from list_brand_profiles. Default: the social set's own, else the account's default brand profile.
Example
curl -X GET "https://buzzmark.ai/api/v1/insights?social_set_id=12" \ -H "Authorization: Bearer $BUZZMARK_API_KEY"
Where to next
- Overview
Buzzmark's REST API lets your code, n8n or Make read your social sets, save drafts, check posts against each platform's rules and schedule them, with a personal key.
- Errors and limits
A Buzzmark API refusal is JSON with a code, a message, whether a retry may work, and a request id, and its HTTP status matches the code.
- Keys and scopes
A Buzzmark API key, made in Settings under Developers, has one scope: Read, Draft (reads too) or Schedule (reads and drafts too).
- n8n and Make
n8n and Make call the Buzzmark API from n8n's HTTP Request node or Make's HTTP module, with your key in the Authorization header.