BlackTwist

Showing 25 of 30 from the live probe.

• List Providers

  List all connected social media accounts (Threads and Bluesky) for the authenticated user. Returns provider ID, platform, username, display name, and profile picture for each account.

• List Posts

  List scheduled and published posts within a date range. Returns threads with their posts, scheduled time, provider info, and analytics. IMPORTANT: Always send from/to as local times WITHOUT a timezone offset (e.g. '2025-03-01T00:00:00'). The server converts to UTC using the user's configured timezone.

• List Drafts

  List all draft posts (posts that have not been scheduled yet). Returns threads with their posts and content.

• Get Thread

  Get a specific thread by its thread ID. Returns all posts in the thread with their content, media, scheduling info, and analytics.

• Create Post

  Create a new post or thread. A thread is multiple posts linked together. Supports text content, topic tags, images (via public URL), auto-repost configuration, and scheduling. If scheduleAt is not provided, the post is saved as a draft. IMPORTANT: Always send scheduleAt as a local time WITHOUT a timezone offset (e.g. '2025-03-15T09:00:00', never with Z or +00:00). The server automatically converts it to UTC using the user's configured timezone.

• Delete Thread

  Delete a thread and all its posts. This action cannot be undone.

• Edit Post

  Edit the text content, topic, or media of a single post by its ID. Only posts with status READY (drafts or scheduled) can be edited. Use get_thread first to retrieve post IDs.

• Edit Thread

  Edit a thread by adding, removing, or reordering its posts. Provide the full desired list of posts — existing posts (with id) are updated, new posts (without id) are created, and existing posts not in the list are removed. Only threads where all posts have status READY can be edited.

• Reschedule Thread

  Reschedule a thread to a new date/time. Updates all posts in the thread. IMPORTANT: Always send scheduledAt as a local time WITHOUT a timezone offset. The server converts to UTC using the user's configured timezone.

• Set Thread Auto Repost

  Set or remove auto-repost on an existing thread. Auto-repost republishes the thread's first post after the given delays have elapsed since publishing. Pass enabled: false to turn it off. Use get_user_settings to read the user's default delays, and get_thread to see a thread's current autoRepostDelay.

• Get Live Metrics

  Get live engagement metrics for a social account over a date range. Returns views, likes, replies, reposts, and quotes with percentage change vs. the previous period. Works with both Threads and Bluesky.

• Get Metric Timeseries

  Get time-series data points for a specific metric. Available metrics: VIEWS, LIKES, REPLIES, REPOSTS, QUOTES, ENGAGEMENT_RATE, FOLLOWERS_COUNT. Returns daily data points.

• Get Post Analytics

  Get analytics for individual posts published within a date range. Returns engagement metrics (views, likes, replies, reposts, quotes, engagement rate) for each post, plus a `thread` array of continuation parts when the post is a multi-post thread (omit by passing includeThreadParts: false).

• Get Follower Growth

  Get follower count over time for a social account. Returns daily follower count data points.

• Get Consistency

  Get posting consistency data for the past 365 days. Returns a heatmap-style array of daily post counts, total posts, and number of days with posts.

• Get Daily Recap

  Get yesterday's daily recap for a social account. Returns new followers gained and number of posts published.

• Get Recommendations

  Get AI-generated posting recommendations based on your analytics and performance patterns. Returns best posting times and content suggestions.

• Get Best Time To Post

  Get the best times to post for a social account, based on historical engagement over the last 10 weeks. Hours are reported in the user's own timezone (resolved automatically from their account settings). Returns engagement broken down by hour of day — both averaged across the whole week and per day of the week — plus the best posting hour for each day. Requires MCP access, which is included in the Creator and Agency plans: the user must be on one of those plans, or be part of a team whose owner

• Get Follow Up Templates

  Get all follow-up (auto-plug) templates for a specific provider. These are reusable templates that define what reply to attach to a post after it reaches engagement thresholds.

• Get Thread Follow Up

  Get the follow-up (auto-plug) configuration for a specific thread.

• Set Thread Follow Up

  Set or update the follow-up (auto-plug) for a thread. The follow-up is a reply that gets posted after the original post reaches engagement thresholds. IMPORTANT: This creates an AutoPlug record (not a DefaultAutoPlug template). The autoPlugId on posts references this record.

• List Time Slots

  List all configured posting time slots for a provider. Time slots define the preferred times when posts should be scheduled. Each slot has an hour, minute, and array of weekdays (0=Sunday, 6=Saturday).

• Get Subscription

  Get the current user's subscription and plan information. Returns plan type, remaining posts, account limits, and team limits.

• Get User Settings

  Get the current user's settings including timezone, date format, auto-repost configuration, and reminder preferences.

• List Teams

  List all teams the authenticated user belongs to, including their role and which team is currently active. Use the team ID as the teamId parameter in other tools. To access the personal workspace (no team), pass teamId "personal".