X Ads promoted posts

Account ID

X Ads account ID selected in SourcesRequired · account_id

Count

Number of records to return per page (1-1000)Optional · count

Cursor

Pagination cursor from a previous responseOptional · cursor

Line item IDs

Comma-separated line item IDs to scope the promoted posts toOptional · line_item_ids

Promoted tweet IDs

Comma-separated promoted post IDs to fetch specific records (max 200)Optional · promoted_tweet_ids

Sort by

Sort order as attribute-direction, e.g. created_at-asc or updated_at-descOptional · sort_by

With deleted

Include soft-deleted promoted posts in the response (default false)Optional · with_deleted

With total count

Include the total_count response attribute (default false; exclusive with cursor)Optional · with_total_count

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• X Ads account postsX Ads$0.005
• X Ads account statsX Ads$0.005
• X ads accountsX Ads$0.005
• X Ads active entitiesX Ads$0.005
• X Ads campaignX Ads$0.005
• X Ads campaign reachX Ads$0.005
• X Ads campaignsX Ads$0.005
• X Ads funding instrumentsX Ads$0.005
• Compare all 16