X / Twitter Automation by Apoth3osis

Name: X / Twitter Automation
Brand: Apoth3osis
SKU: 69fd3f8f564f18a7b599859f
Price: 0.05 USD
Availability: InStock

X / Twitter Automation

Function

Available ActionsEach successful request consumes credits as outlined below.

lookup_posts^5crsearch_posts^5crcreate_post^5crcreate_post_with_link^25crcreate_reply^5crcreate_reply_with_link^25crdelete_post^5crset_reply_hidden^5crset_like^5crset_repost^5crlookup_post_engagers^5crlookup_users^5crset_follow^5crlookup_follows^5crlookup_timeline^5crlookup_dms^5crsend_dm^5crupload_media^5crcreate_list^1crupdate_list^1crdelete_list^1crset_list_membership^1crset_list_follow^1crset_list_pin^1crlookup_lists^1crlookup_list_contents^1cr

Details

X (Twitter) automation for AI agents and social media teams. Connect your X account once and run your entire publishing, engagement, and social listening workflow from a single MCP-ready API. Post tweets and replies, attach images, GIFs, and video, and search X for brand keywords, mentions, competitors, and trending topics — then draft and send on-brand replies in seconds. Like, repost, follow, and send DMs; build and curate X Lists; and read your mentions, home, and user timelines for reporting. Built for automated tweet scheduling, brand and competitor monitoring, social media customer support, influencer outreach, and end-to-end X / Twitter / X.com content workflows.

Use Cases

Publish posts and replies to X / Twitter from agent workflows, Schedule and orchestrate Twitter content calendars, Search recent X posts for brand monitoring, competitor tracking, and trend detection, Draft and send on-brand replies to the conversations that matter, Upload images, GIFs, and video to X from File Manager files or any public URL, Run social media customer support over X DMs, Send launch announcements and follow-up DMs from automations, Like, repost, and follow as part of engagement automations, Hide spam or off-topic replies on your own posts, Build and curate X Lists for launch watch, competitor watch, and community segmentation, Read mentions, home, and user timelines for social analytics and reporting, Resolve X users by ID, username, or the authenticated account

Actions(26)

lookup_posts^5cr3 params

Get one or more X posts by ID with curated field verbosity.

post_idstring

Single post ID to fetch.

post_idsarray

Multiple post IDs to fetch.

Array of: string

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

search_posts^5cr6 params(1 required)

Search recent X posts from the last 7 days.

queryrequiredstring

X recent-search query.

start_timestring

RFC3339 start time for recent search, for example 2026-05-14T18:00:00Z.

end_timestring

RFC3339 end time for recent search, for example 2026-05-14T19:00:00Z.

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

create_post^5cr2 params

Create a top-level X post without links. Use create_post_with_link for text containing web links. Quote-post creation is not supported.

textstring

Link-free post text. Required unless media_ids is provided.

media_idsarray

Media IDs to attach, max 4.

Array of: string

create_post_with_link^25cr2 params(1 required)

Create a top-level X post whose text contains at least one web link. Quote-post creation is not supported.

textrequiredstring

Post text containing at least one web link.

media_idsarray

Media IDs to attach, max 4.

Array of: string

create_reply^5cr3 params(1 required)

Reply to another X post without links. X self-serve plans may restrict replies unless the original author has summoned the authenticated account.

reply_to_post_idrequiredstring

Post ID to reply to.

textstring

Link-free reply text. Required unless media_ids is provided.

media_idsarray

Media IDs to attach, max 4.

Array of: string

create_reply_with_link^25cr3 params(2 required)

Reply to another X post with text containing at least one web link. X self-serve plans may restrict replies unless the original author has summoned the authenticated account.

reply_to_post_idrequiredstring

Post ID to reply to.

textrequiredstring

Reply text containing at least one web link.

media_idsarray

Media IDs to attach, max 4.

Array of: string

delete_post^5cr1 param(1 required)

Delete a post by ID.

post_idrequiredstring

Post ID to delete.

set_reply_hidden^5cr2 params(2 required)

Hide or unhide a reply on your post.

reply_post_idrequiredstring

Reply post ID to hide or unhide.

hiddenrequiredboolean

True to hide, false to unhide.

set_like^5cr2 params(2 required)

Like or unlike a post as the authenticated user.

post_idrequiredstring

Post ID to like or unlike.

likedrequiredboolean

True to like, false to unlike.

set_repost^5cr2 params(2 required)

Repost or undo repost as the authenticated user.

post_idrequiredstring

Post ID to repost or undo repost.

repostedrequiredboolean

True to repost, false to undo repost.

lookup_post_engagers^5cr5 params(2 required)

List users who liked or reposted a post, or list quote posts.

post_idrequiredstring

Post ID to inspect.

engagement_typerequiredstring

Engagement to retrieve: likes, reposts, or quotes.

Values:

likesrepostsquotes

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

lookup_users^5cr6 params(1 required)

Resolve users by ID, username, or the authenticated account.

lookup_byrequiredstring

Lookup mode: ids, usernames, or me.

Values:

idsusernamesme

user_idstring

Single user ID for ids mode.

user_idsarray

Multiple user IDs for ids mode.

Array of: string

usernamestring

Single username without @ for usernames mode.

usernamesarray

Multiple usernames without @ for usernames mode.

Array of: string

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

set_follow^5cr2 params(2 required)

Follow or unfollow a user as the authenticated user.

user_idrequiredstring

Target user ID to follow or unfollow.

followingrequiredboolean

True to follow, false to unfollow.

lookup_follows^5cr5 params(2 required)

List followers or followed users for a user.

user_idrequiredstring

User ID to inspect.

relationshiprequiredstring

Relationship list to retrieve: followers or following.

Values:

followersfollowing

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

lookup_timeline^5cr5 params(1 required)

Read user posts, mentions, or authenticated home timeline.

timeline_typerequiredstring

Timeline mode: user_posts, mentions, or home.

Values:

user_postsmentionshome

user_idstring

User ID required for user_posts and mentions; optional for home.

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

lookup_dms^5cr7 params(1 required)

Read DM events by scope: all, conversation, participant, or event_id.

scoperequiredstring

DM lookup scope: all, conversation, participant, or event_id.

Values:

allconversationparticipantevent_id

conversation_idstring

Conversation ID for conversation scope.

participant_user_idstring

Participant user ID for participant scope.

event_idstring

DM event ID for event_id scope.

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

send_dm^5cr6 params(1 required)

Send a DM to a participant, existing conversation, or new group.

target_typerequiredstring

Target mode: participant, conversation, or new_group.

Values:

participantconversationnew_group

participant_user_idstring

Participant user ID for participant mode.

conversation_idstring

Conversation ID for conversation mode.

participant_user_idsarray

Participant user IDs for new_group mode.

Array of: string

textstring

DM text. Required unless media_id is provided.

media_idstring

Optional uploaded DM media ID. One media attachment is supported.

upload_media^5cr4 params(2 required)

Upload image, GIF, or video media for posts or DMs and return a media ID.

media_typerequiredstring

Media kind: image, gif, or video.

Values:

imagegifvideo

usage_contextrequiredstring

Where the media will be used: post or dm.

Values:

postdm

file_idstring

AgentPMT File Manager file ID to upload.

source_urlstring

Public URL to fetch and upload.

create_list^1cr3 params(1 required)

Create a new X List for the authenticated user.

list_namerequiredstring

List name, 1-25 characters.

list_descriptionstring

Optional List description, max 100 characters.

list_privateboolean

True to create a private List.

update_list^1cr4 params(1 required)

Update a List's name, description, or privacy setting.

list_idrequiredstring

List ID to update.

list_namestring

New List name, 1-25 characters.

list_descriptionstring

New List description, max 100 characters. Use an empty string to clear.

list_privateboolean

True for private, false for public.

delete_list^1cr1 param(1 required)

Delete a List owned by the authenticated user.

list_idrequiredstring

List ID to delete.

set_list_membership^1cr3 params(3 required)

Add or remove a user as a member of a List owned by the authenticated user.

list_idrequiredstring

List ID to modify.

user_idrequiredstring

User ID to add or remove.

is_memberrequiredboolean

True to add, false to remove.

set_list_follow^1cr2 params(2 required)

Follow or unfollow a List as the authenticated user.

list_idrequiredstring

List ID to follow or unfollow.

followingrequiredboolean

True to follow, false to unfollow.

set_list_pin^1cr2 params(2 required)

Pin or unpin a followed or owned List for the authenticated user.

list_idrequiredstring

List ID to pin or unpin.

pinnedrequiredboolean

True to pin, false to unpin.

lookup_lists^1cr6 params(1 required)

Look up one List or list owned, membership, followed, or pinned Lists.

list_scoperequiredstring

Lookup scope: id, owned, memberships, followed, or pinned.

Values:

idownedmembershipsfollowedpinned

list_idstring

Required when list_scope is id.

user_idstring

Optional for owned, memberships, and followed scopes. Omit for pinned because pinned Lists use the authenticated user.

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

lookup_list_contents^1cr5 params(2 required)

List members, followers, or posts for a List.

list_idrequiredstring

List ID to inspect.

list_viewrequiredstring

Content view: members, followers, or posts.

Values:

membersfollowersposts

max_resultsinteger

Maximum results to return, 1-100.

pagination_tokenstring

Pagination token from a previous response.

verbositystring

Response detail level: minimal, standard, or expanded.

Values:

minimalstandardexpanded

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "69fd3f8f564f18a7b599859f",
    "parameters": {
      "action": "lookup_posts"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "69fd3f8f564f18a7b599859f",
    "parameters": {
        "action": "lookup_posts"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69fd3f8f564f18a7b599859f",
  parameters: {
    "action": "lookup_posts"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69fd3f8f564f18a7b599859f",
  parameters: {
    "action": "lookup_posts"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

X / Twitter Automation

Operate a connected X (Twitter) account end-to-end from agents and workflows: publish posts and replies, upload media, search recent posts, read timelines and DMs, engage, and manage Lists.

Common workflows

On-brand reply queue: search_posts for your brand or topic over the last day and review the best candidates. You can only reply to a post you have already engaged with or that tags your account, so engage first (for example set_like or set_repost) or focus on posts that mention you, then create_reply (or create_reply_with_link) with on-brand drafts.
Publish with media: upload_media to get media_ids, then create_post (or create_post_with_link when the text has a URL).
Brand & competitor monitoring: search_posts on keywords plus lookup_timeline (mentions) and curated lookup_lists.
Customer support over DMs: lookup_dms to read threads, send_dm to respond.

Posting links

Use create_post / create_reply for text without a web link. When the text contains a URL (http://, https://, www., or a bare domain), use create_post_with_link / create_reply_with_link.

Actions

`search_posts`

Required: query (string). Optional: start_time, end_time (RFC3339 timestamps), max_results (1-100, default 10), pagination_token, verbosity (minimal|standard|expanded, default expanded). Example: {"action":"search_posts","query":"agentpmt OR \"AI agents\" -is:retweet lang:en","start_time":"2026-05-22T13:00:00Z","end_time":"2026-05-23T13:00:00Z","max_results":25} For List-specific recent search, use the X search operator in query, for example list:2055003862814040388, plus start_time and end_time.

`lookup_posts`

Required: exactly one of post_id (string) or post_ids (string[], max 100). Optional: verbosity. Example: {"action":"lookup_posts","post_ids":["123","456"],"verbosity":"standard"}

`create_post`

Creates a top-level post. Required: text or media_ids. Optional: media_ids (string[], max 4). For text that contains a web link, use create_post_with_link. Example: {"action":"create_post","text":"Shipping from AgentPMT","media_ids":["123"]}

`create_post_with_link`

Creates a top-level post whose text contains a web link. Required: text with a link. Optional: media_ids (string[], max 4). Example: {"action":"create_post_with_link","text":"Launch notes: https://example.com/agentpmt","media_ids":["123"]}

`create_reply`

Replies to another post. You can only reply to a post the connected account has already engaged with (liked, reposted, quoted, or previously replied to) or that tags your account (mentions or quotes you); replies to any other post are rejected. Required: reply_to_post_id and text or media_ids. Optional: media_ids (string[], max 4). For replies whose text contains a web link, use create_reply_with_link. Example: {"action":"create_reply","reply_to_post_id":"123","text":"Thanks for the mention."}

`create_reply_with_link`

Replies to another post with text that contains a web link. The same reply restriction applies: you can only reply to a post the connected account has already engaged with or that tags your account. Required: reply_to_post_id and text with a link. Optional: media_ids (string[], max 4). Example: {"action":"create_reply_with_link","reply_to_post_id":"123","text":"Details are here: https://example.com/agentpmt"}

`delete_post`

Required: post_id. Example: {"action":"delete_post","post_id":"123"}

`set_reply_hidden`

Required: reply_post_id, hidden (boolean). Example: {"action":"set_reply_hidden","reply_post_id":"123","hidden":true}

`set_like`

Required: post_id, liked (boolean). Example: {"action":"set_like","post_id":"123","liked":true}

`set_repost`

Required: post_id, reposted (boolean). Example: {"action":"set_repost","post_id":"123","reposted":true}

`lookup_post_engagers`

Required: post_id, engagement_type (likes|reposts|quotes). Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_post_engagers","post_id":"123","engagement_type":"likes","max_results":25}

`lookup_users`

Required: lookup_by (ids|usernames|me). For ids, set exactly one of user_id or user_ids. For usernames, set exactly one of username or usernames. Optional: verbosity. Example: {"action":"lookup_users","lookup_by":"usernames","usernames":["XDevelopers"]}

`set_follow`

Required: user_id, following (boolean). Example: {"action":"set_follow","user_id":"123","following":true}

`lookup_follows`

Required: user_id, relationship (followers|following). Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_follows","user_id":"123","relationship":"followers","max_results":50}

`lookup_timeline`

Required: timeline_type (user_posts|mentions|home). user_id is required for user_posts and mentions; optional for home. Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_timeline","timeline_type":"home","max_results":20}

`lookup_dms`

Required: scope (all|conversation|participant|event_id). Set conversation_id, participant_user_id, or event_id for the matching scope. Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_dms","scope":"participant","participant_user_id":"123","max_results":20}

`send_dm`

Required: target_type (participant|conversation|new_group) and text or media_id. Set participant_user_id, conversation_id, or participant_user_ids for the matching target. Example: {"action":"send_dm","target_type":"participant","participant_user_id":"123","text":"Here is the post: https://x.com/i/status/456"}

`upload_media`

Required: exactly one of file_id or source_url, plus media_type (image|gif|video) and usage_context (post|dm). Example: {"action":"upload_media","file_id":"file_abc","media_type":"image","usage_context":"post"}

`create_list`

Creates a new List for the authenticated user. Required: list_name (1-25 characters). Optional: list_description (max 100 characters), list_private (boolean). Example: {"action":"create_list","list_name":"Launch Watch","list_description":"Accounts to monitor for launch week","list_private":true}

`update_list`

Updates an existing List. Required: list_id and at least one of list_name, list_description, or list_private. Use list_description:"" to clear the description and list_private:false to make the List public. Example: {"action":"update_list","list_id":"123","list_name":"Launch Signals","list_private":false}

`delete_list`

Deletes a List owned by the authenticated user. Required: list_id. Example: {"action":"delete_list","list_id":"123"}

`set_list_membership`

Adds or removes a user from a List owned by the authenticated user. Required: list_id, user_id, is_member (boolean). Example: {"action":"set_list_membership","list_id":"123","user_id":"456","is_member":true}

`set_list_follow`

Follows or unfollows a List as the authenticated user. Required: list_id, following (boolean). Example: {"action":"set_list_follow","list_id":"123","following":true}

`set_list_pin`

Pins or unpins a followed or owned List for the authenticated user. Required: list_id, pinned (boolean). Example: {"action":"set_list_pin","list_id":"123","pinned":true}

`lookup_lists`

Looks up one List or Lists by relationship. Required: list_scope (id|owned|memberships|followed|pinned). For id, set list_id. For owned, memberships, or followed, user_id is optional and defaults to the authenticated user. For pinned, omit user_id. Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_lists","list_scope":"owned","max_results":25,"verbosity":"standard"}

`lookup_list_contents`

Lists members, followers, or posts for a List. Required: list_id, list_view (members|followers|posts). Optional: max_results, pagination_token, verbosity. Example: {"action":"lookup_list_contents","list_id":"123","list_view":"members","max_results":50}

Response

All actions return action. List actions also return data, optional includes, optional meta, and next_token.

Notes

Search covers recent posts (about the last 7 days). For quote activity on a post, use lookup_post_engagers with engagement_type:"quotes".
Replies are limited to posts you are already connected to. You can only post a reply (create_reply / create_reply_with_link) to a post when the connected account has already engaged with it (liked, reposted, quoted, or previously replied to it) or has been tagged in it (the post mentions or quotes your account). Replies to posts you have not engaged with and that do not tag you are rejected. To reply to a post surfaced by search_posts, engage with it first (for example set_like or set_repost) or choose a post that mentions you. If a reply is still rejected for access or policy reasons, move to another permitted post rather than retrying the same one.
List read actions need the connected token's list.read scope; create, update, delete, membership, follow, and pin actions need list.write. If a List call returns a scope-related 403, reconnect the X account to refresh scopes.

About this Product

Run your entire X (Twitter) presence from one connected account

X / Twitter Automation gives AI agents and social teams a single, MCP-ready API to publish, engage, listen, and report on X. Connect your account once, then post, reply, monitor mentions, draft on-brand responses, and send DMs — by hand or fully automated through agent workflows.

What you can do

Publish

Post tweets and replies to X / Twitter, with or without links.
Attach images, GIFs, and video uploaded from File Manager or any public URL.
Schedule and orchestrate content calendars from autonomous agents and workflows.

Listen & monitor

Search recent X posts for brand keywords, mentions, competitors, and trending topics.
Read your mentions, home, and user timelines for analytics and reporting.
See who liked, reposted, or quoted any post.

Engage

Draft and send on-brand replies to the conversations that matter most.
Like, repost, and follow as part of automated engagement.
Hide spam or off-topic replies on your own posts to keep threads clean.

Direct messages

Run social media customer support over X DMs.
Send launch announcements, follow-ups, and outreach to people, existing conversations, or new group chats.

Lists

Build and curate X Lists for launch watch, competitor watch, and community segmentation.
Follow, pin, and manage membership of Lists, and read their members, followers, and posts.

Popular workflows

On-brand reply queue — surface the best recent posts about your topic and draft replies that match your brand voice.
Launch day — publish an announcement with a graphic and link, then monitor reactions and reply to the highest-signal ones.
Always-on brand monitoring — track mentions and competitors, and surface conversations worth joining.
DM customer support — read and respond to support conversations straight from your agents.

Getting started

Connect your X account once with secure OAuth. From there, your agents can publish, search, engage, and DM on your behalf across any workflow.

Frequently Asked Questions

Can it draft replies that match my brand voice?

Yes. Search recent posts about your topic or brand, then have your agent draft on-brand replies for you to review and send — one at a time or in batches.

Can it post images, GIFs, and video?

Yes. Upload media from File Manager or any public URL and attach it to posts, replies, or DMs.

Does it work with autonomous agents and scheduled workflows?

Yes. Every capability is available to agents and workflows, so you can schedule content, automate engagement, and run always-on monitoring.

How do I connect my X account?

Connect once through secure OAuth. After that, your agents act on your connected account across any workflow.

How does brand and competitor monitoring work?

Search recent X posts by keyword, hashtag, or account, read your mentions and home timelines, and curate X Lists to watch the accounts that matter to you.

What can I do with X / Twitter Automation?

Publish posts and replies, upload images, GIFs, and video, search recent X posts for brand and competitor mentions, read your mentions and timelines, like, repost, and follow, send DMs, and build and manage X Lists — all from agents and automated workflows on a connected X account.

X / Twitter Automation

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(26)

About this Product

Run your entire X (Twitter) presence from one connected account

What you can do

Publish

Listen & monitor

Engage

Direct messages

Lists

Popular workflows

Getting started

Frequently Asked Questions

Can it draft replies that match my brand voice?

Can it post images, GIFs, and video?

Does it work with autonomous agents and scheduled workflows?

How do I connect my X account?

How does brand and competitor monitoring work?

What can I do with X / Twitter Automation?

Looking for help integrating AI into your business? Set up a free consultation.