X
Programmatic access to X platform data and features
Actions (94)
Ads API · 42
- Attach Media to CreativePOST /5/accounts/{account_id}/media_creatives
Attach uploaded media to a creative.
documented - Attach Media to CreativePOST /5/accounts/{account_id}/media_creatives
Attach uploaded media to a creative.
documented - Batch Create CreativesPOST /5/batch/creative
Create multiple creatives in a single request.
documented - Batch Create CreativesPOST /5/accounts/{account_id}/batch/creative
Create multiple creatives in a single request.
documented - Batch Create Targeting CriteriaPOST /5/batch/accounts/{account_id}/targeting_criteria
Batch create targeting criteria.
documented - Batch Create Targeting CriteriaPOST /5/batch/accounts/{account_id}/targeting_criteria
Batch create targeting criteria.
documented - Create CampaignPOST /5/accounts/{account_id}/campaigns
Create a new ad campaign under an advertiser account.
documented - Create CampaignPOST /5/accounts/{account_id}/campaigns
Create a new ad campaign.
documented - Create Line ItemPOST /5/accounts/{account_id}/line_items
Create a new line item under a campaign.
documented - Create Line ItemPOST /5/accounts/{account_id}/line_items
Create a new line item under a campaign.
documented - Create Line Item Curated CategoriesPOST /5/accounts/{account_id}/line_item_curated_categories
Associate curated categories with a line item.
documented - Create Line Item Curated CategoriesPOST /5/accounts/{account_id}/line_item_curated_categories
Associate curated categories with a line item.
documented - Create Media CreativePOST /5/accounts/{account_id}/media_library
Create a media creative to be used in ads.
documented - Create Media CreativePOST /5/accounts/{account_id}/media_library
Create a media creative to be used in ads.
documented - Create Targeting CriteriaPOST /5/accounts/{account_id}/targeting_criteria
Create targeting criteria for ad campaigns.
documented - Create Targeting CriteriaPOST /5/accounts/{account_id}/targeting_criteria
Create targeting criteria for ad campaigns.
documented - Delete CampaignDELETE /5/accounts/{account_id}/campaigns/{campaign_id}
Delete a campaign.
documented - Delete CampaignDELETE /5/accounts/{account_id}/campaigns/{campaign_id}
Delete a campaign.
documented - Delete Line ItemDELETE /5/accounts/{account_id}/line_items/{line_item_id}
Delete a line item.
documented - Delete Line ItemDELETE /5/accounts/{account_id}/line_items/{line_item_id}
Delete a line item.
documented - Get CampaignGET /5/accounts/{account_id}/campaigns/{campaign_id}
Retrieve a specific campaign.
documented - Get CampaignGET /5/accounts/{account_id}/campaigns/{campaign_id}
Retrieve a specific campaign.
documented - Get Content CategoriesGET /5/content_categories
Retrieve content categories for targeting.
documented - Get Content CategoriesGET /5/content_categories
Retrieve content categories for targeting.
documented - Get Line ItemGET /5/accounts/{account_id}/line_items/{line_item_id}
Retrieve a specific line item.
documented - Get Line ItemGET /5/accounts/{account_id}/line_items/{line_item_id}
Retrieve a specific line item.
documented - Get PublishersGET /5/publishers
List available publishers.
documented - Get PublishersGET /5/publishers
List available publishers.
documented - Get Targeting CriteriaGET /5/accounts/{account_id}/targeting_criteria
List targeting criteria for an account.
documented - Get Targeting CriteriaGET /5/accounts/{account_id}/targeting_criteria
List targeting criteria for an account.
documented - List CampaignsGET /5/accounts/{account_id}/campaigns
List campaigns under an advertiser account.
documented - List Campaigns (ads)GET /2/ads/campaigns
List campaigns for an advertiser account.
documented - List Line ItemsGET /5/accounts/{account_id}/line_items
List line items in an advertiser account.
documented - List Line ItemsGET /5/accounts/{account_id}/line_items
List line items in an advertiser account.
documented - Set Preroll CTAPOST /5/accounts/{account_id}/preroll_call_to_action
Configure a preroll call-to-action for video ads.
documented - Set Preroll CTAPOST /5/accounts/{account_id}/preroll_call_to_action
Configure a preroll call-to-action for video ads.
documented - Update CampaignPUT /5/accounts/{account_id}/campaigns/{campaign_id}
Update an existing campaign.
documented - Update CampaignPUT /5/accounts/{account_id}/campaigns/{campaign_id}
Update an existing campaign.
documented - Update Line ItemPUT /5/accounts/{account_id}/line_items/{line_item_id}
Update a line item.
documented - Update Line ItemPUT /5/accounts/{account_id}/line_items/{line_item_id}
Update a line item.
documented - Upload Media to CampaignPOST /5/accounts/{account_id}/campaigns/{campaign_id}/media_library
Upload media to be used in a campaign.
documented - Upload Media to CampaignPOST /5/accounts/{account_id}/campaigns/{campaign_id}/media_library
Upload media to be used in a campaign.
documented
Posts · 10
- Create Filtered Stream RulePOST /2/tweets/search/stream/rules
Add a rule to the filtered stream.
documented - Create or Update PostPOST /2/tweets
Create a new post or update an existing one when edit_options are provided.
documented - Delete PostDELETE /2/tweets/{id}
Delete a post by ID (owned by authenticated user).
documented - Filtered StreamGET /2/tweets/search/stream
Connect to real-time filtered stream of posts.
documented - Get Home TimelineGET /2/users/{id}/timelines/reverse_chronological
Retrieve the authenticated user’s home timeline.
documented - Get Post by IDGET /2/tweets/{id}
Retrieve a single post by its ID.
documented - Get Posts by IDsGET /2/tweets
Retrieve multiple posts by IDs.
documented - Get User Mentions TimelineGET /2/users/{id}/mentions
Retrieve posts that mention a specific user.
documented - Get User Posts TimelineGET /2/users/{id}/tweets
Retrieve posts authored by a specific user.
documented - List Filtered Stream RulesGET /2/tweets/search/stream/rules
List all rules for the filtered stream.
documented
Media · 8
- Add SubtitlesPOST /2/media/subtitles
Attach subtitles to a media item.
documented - Append to Media UploadPOST /2/media/upload/:id/append
Append data to an ongoing chunked media upload.
documented - Check Media Upload StatusGET /2/media/upload
Poll or check status of a media upload.
documented - Delete SubtitlesDELETE /2/media/subtitles
Remove subtitles from a media item.
documented - Finalize Media UploadPOST /2/media/upload/:id/finalize
Finalize a chunked media upload and obtain a media_id.
documented - Initialize Media UploadPOST /2/media/upload/initialize
Initialize a chunked media upload session.
documented - Set Media MetadataPOST /2/media/metadata
Attach metadata (e.g., alt text) to a media object.
documented - Upload MediaPOST /2/media/upload
Upload a media asset (image, video, etc.) for use in posts or DMs.
documented
Spaces · 7
- Get Space BuyersGET /2/spaces/:id/buyers
List ticket buyers for a Space.
documented - Get Space TweetsGET /2/spaces/:id/tweets
Get Posts shared in a Space.
documented - Get Space by IDGET /2/spaces/:id
Retrieve a Space by its ID.
documented - Get Spaces by Creator IDsGET /2/spaces/by/creator_ids
Find Spaces hosted by specific users.
documented - Get Spaces by IDsGET /2/spaces
Retrieve multiple Spaces by IDs.
documented - Search SpacesGET /spaces/search
Search for Spaces by keyword.
documented - Search Spaces (alternate)GET /2/spaces/search
Alternate endpoint to search for Spaces by keyword.
documented
Webhooks · 6
- Create WebhookPOST /2/webhooks
Create a new webhook configuration.
documented - Create Webhook Replay JobPOST /2/webhooks/replay
Create a replay job for a webhook.
documented - Delete WebhookDELETE /2/webhooks/:webhook_id
Delete a webhook configuration.
documented - Get WebhooksGET /2/webhooks
List webhook configurations.
documented - Get WebhooksGET /2/webhooks
List webhook configurations.
documented - Update WebhookPUT /2/webhooks/:webhook_id
Update an existing webhook configuration.
documented
Bookmarks · 5
- Bookmark a PostPOST /2/users/{id}/bookmarks
Add a bookmark for a post on behalf of the authenticated user.
documented - Get Bookmark FoldersGET /2/users/{id}/bookmarks/folders
List bookmark folders for the user.
documented - Get BookmarksGET /2/users/{id}/bookmarks
Retrieve bookmarks for the authenticated user.
documented - Get Posts in Bookmark FolderGET /2/users/{id}/bookmarks/folders/{folder_id}
Retrieve posts contained in a bookmark folder.
documented - Remove BookmarkDELETE /2/users/{id}/bookmarks/{tweet_id}
Remove a bookmark for a post.
documented
Likes · 5
- Get Liked PostsGET /2/users/{id}/liked_tweets
Retrieve posts liked by the specified user.
documented - Get Liked Posts (alternate)GET /2/likes
Alternate access to liked posts (if exposed in API).
documented - Get Liking UsersGET /2/tweets/{id}/liking_users
Retrieve users who liked a specific post.
documented - Like PostPOST /2/users/{id}/likes
Like a specific post on behalf of the authenticated user.
documented - Unlike PostDELETE /2/users/{id}/likes/{tweet_id}
Unlike a specific post on behalf of the authenticated user.
documented
X Activity · 5
- Create X Activity SubscriptionPOST /2/activity/subscriptions
Create an activity subscription for X activity streams.
documented - Delete X Activity SubscriptionDELETE /2/activity/subscriptions/:subscription_id
Delete a specific activity subscription.
documented - Get X Activity StreamGET /2/activity/stream
Stream of X activities (near real-time).
documented - Get X Activity SubscriptionsGET /2/activity/subscriptions
List active X Activity subscriptions.
documented - Update X Activity SubscriptionPUT /2/activity/subscriptions/:subscription_id
Update a specific activity subscription.
documented
Users · 4
- Get Authenticated UserGET /2/users/me
Retrieve the profile of the authenticated user.
documented - Get User by IDGET /2/users/{id}
Retrieve a user profile by ID.
documented - Get User by UsernameGET /2/users/by/username/{username}
Retrieve a user by their username/handle.
documented - Get Users by UsernamesGET /2/users/by
Retrieve multiple users by their usernames.
documented