Skip to the page

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/me

The 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-sets

Every 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/channels

Every 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-profiles

The 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-times

When 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/drafts

Saves 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/posts

Buzzes 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/posts

Schedules 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/validate

A 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/bulk

Schedules 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}/reschedule

Moves 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}/unschedule

Takes 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}/retry

Sends 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-url

For 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-upload

After 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-url

Copies 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/images

Buzzmark'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}/stats

A 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/posts

A 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/write

Buzz 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/rewrite

Buzz 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/check

Hive 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/adapt

Rewrites 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/ideas

Scout'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/insights

What 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