social accounts

view connected social media accounts for a workspace. accounts are connected through the antwork dashboard via oauth.

get_platform_limits

get character limits, supported media types, and content specs for all platforms. use this to understand platform constraints before creating or generating posts.

> what are the character limits for each platform?
  using antwork.get_platform_limits

  [done] specs for 8 platforms returned
  [info] x: 280 chars, linkedin: 3000 chars, instagram: 2200 chars...
parameters

list_social_accounts

retrieve active social media accounts connected to a workspace. returns platform, account name, and handle for each connection.

> what social accounts do i have connected?
  using antwork.list_social_accounts

  [done] 3 connected accounts
  [info] linkedin: @johndoe, x: @johndoe, instagram: @johndoe
parameters
workspace_idstringoptional
workspace id or name. optional if user has only one workspace

get_connection_urls

get oauth connection urls for each social platform. returns urls the user can open in a browser to connect their accounts, plus lists of already-connected and not-connected platforms.

> how do i connect my instagram?
  using antwork.get_connection_urls

  [done] connection urls generated
  [info] connected: linkedin, x · not connected: instagram, facebook, threads
parameters
workspace_idstringoptional
workspace id or name. optional if user has only one workspace

fetch_platform_posts

fetch the most recent posts directly from a connected social account's platform api. useful as context before generating new content (avoid repeating themes, learn from what's recent). not the same as list_posts, which reads antwork's local post records.

> what did i post on linkedin recently?
  using antwork.fetch_platform_posts

  [done] 5 posts fetched
  [info] from linkedin · last 7 days
parameters
workspace_idstringoptional
workspace id or name. optional if user has only one workspace
platformstringoptional
platform to fetch from (e.g. "linkedin", "x")
social_account_idstringoptional
specific connected account id. omit to use the first matching account.
max_postsnumberoptional
max posts to fetch (default 5)
// supported_platforms

antwork supports connecting accounts from the following platforms:

linkedinxfacebookinstagramthreadsyoutubetiktokpinterest