@font-face {
    font-family: "GraphikWide";
    src: url("https://mintlify-assets.b-cdn.net/x/GraphikWide-Semibold-Trial.woff") format("woff");
    font-weight: 600;
}
.font-branded, h1, h2, h3  {
  font-family: "GraphikWide";
  letter-spacing: -1%;
}
.form {
  padding: 15px;
  width: 100%;
  min-height: 300px;
  overflow-y: auto;
}
.rate-limit-table th {
  text-align: left;
}
tr td[data-label="Endpoint"] a {
  font-size: 12px;
}
tr td[data-label="Pro Limit"],
tr td[data-label="Basic Limit"],
tr td[data-label="Free Limit"] {
  font-size: 12px;
}
td[data-label="Pro Limit"] strong,
td[data-label="Basic Limit"] strong,
td[data-label="Free Limit"] strong {
  margin-bottom: 8px;
  display: block;
}
.text-hero {
  color: white;
  font-weight: 600;
  font-size: 3rem;
  margin: 0;
}
@media (max-width: 767px) {
  .text-hero {
    font-size: 2rem;
  }
}
#assistant-entry span {
  font-size: 0 !important;
  line-height: 0 !important;
}
#assistant-entry span::before {
  content: "Ask Grok";
  font-size: 0.875rem;
  line-height: 1.5rem;
}
#assistant-entry svg {
  display: none !important;
}
#assistant-entry::before {
  content: "";
  display: inline-block;
  width: 18px;
  height: 18px;
  background-image: url("data:image/svg+xml,%3Csvg fill='%23000000' fill-rule='evenodd' height='1em' style='flex:none;line-height:1' viewBox='0 0 24 24' width='1em' xmlns='http://www.w3.org/2000/svg'%3E%3Ctitle%3EGrok%3C/title%3E%3Cpath d='M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-size: contain;
  vertical-align: middle;
}
.dark #assistant-entry::before {
  background-image: url("data:image/svg+xml,%3Csvg fill='%23ffffff' fill-rule='evenodd' height='1em' style='flex:none;line-height:1' viewBox='0 0 24 24' width='1em' xmlns='http://www.w3.org/2000/svg'%3E%3Ctitle%3EGrok%3C/title%3E%3Cpath d='M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815'/%3E%3C/svg%3E");
}
.chat-assistant-sheet-header span.font-semibold {
  font-size: 0 !important;
}
.chat-assistant-sheet-header span.font-semibold::before {
  content: "Grok";
  font-size: 0.875rem;
  font-weight: 600;
}
.chat-assistant-sheet-header svg.size-5.text-primary.dark\:text-primary-light {
  display: none !important;
}
.chat-assistant-sheet-header .flex.items-center.gap-2::before {
  content: "";
  display: inline-block;
  width: 18px;
  height: 18px;
  background-image: url("data:image/svg+xml,%3Csvg fill='%23000000' fill-rule='evenodd' height='1em' style='flex:none;line-height:1' viewBox='0 0 24 24' width='1em' xmlns='http://www.w3.org/2000/svg'%3E%3Ctitle%3EGrok%3C/title%3E%3Cpath d='M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-size: contain;
  vertical-align: middle;
}
.dark .chat-assistant-sheet-header .flex.items-center.gap-2::before {
  background-image: url("data:image/svg+xml,%3Csvg fill='%23ffffff' fill-rule='evenodd' height='1em' style='flex:none;line-height:1' viewBox='0 0 24 24' width='1em' xmlns='http://www.w3.org/2000/svg'%3E%3Ctitle%3EGrok%3C/title%3E%3Cpath d='M9.27 15.29l7.978-5.897c.391-.29.95-.177 1.137.272.98 2.369.542 5.215-1.41 7.169-1.951 1.954-4.667 2.382-7.149 1.406l-2.711 1.257c3.889 2.661 8.611 2.003 11.562-.953 2.341-2.344 3.066-5.539 2.388-8.42l.006.007c-.983-4.232.242-5.924 2.75-9.383.06-.082.12-.164.179-.248l-3.301 3.305v-.01L9.267 15.292M7.623 16.723c-2.792-2.67-2.31-6.801.071-9.184 1.761-1.763 4.647-2.483 7.166-1.425l2.705-1.25a7.808 7.808 0 00-1.829-1A8.975 8.975 0 005.984 5.83c-2.533 2.536-3.33 6.436-1.962 9.764 1.022 2.487-.653 4.246-2.34 6.022-.599.63-1.199 1.259-1.682 1.925l7.62-6.815'/%3E%3C/svg%3E");
}

.mint-pointer-events-none {
    pointer-events: none
}
.mint-absolute {
    position: absolute
}
.mint-relative {
    position: relative
}
.mint-inset-0 {
    inset: 0px
}
.mint-my-2 {
    margin-top: 0.5rem;
    margin-bottom: 0.5rem
}
.mint-mb-2 {
    margin-bottom: 0.5rem
}
.mint-ml-1 {
    margin-left: 0.25rem
}
.mint-ml-1\.5 {
    margin-left: 0.375rem
}
.mint-block {
    display: block
}
.mint-inline-block {
    display: inline-block
}
.mint-flex {
    display: flex
}
.mint-grid {
    display: grid
}
.mint-hidden {
    display: none
}
.mint-h-4 {
    height: 1rem
}
.mint-h-full {
    height: 100%
}
.mint-w-4 {
    width: 1rem
}
.mint-w-full {
    width: 100%
}
.mint-flex-none {
    flex: none
}
.mint-flex-grow {
    flex-grow: 1
}
.mint-cursor-pointer {
    cursor: pointer
}
.mint-grid-cols-1 {
    grid-template-columns: repeat(1, minmax(0, 1fr))
}
.mint-flex-col {
    flex-direction: column
}
.mint-items-center {
    align-items: center
}
.mint-justify-center {
    justify-content: center
}
.mint-gap-4 {
    gap: 1rem
}
.mint-overflow-hidden {
    overflow: hidden
}
.mint-rounded-full {
    border-radius: 9999px
}
.mint-rounded-xl {
    border-radius: 0.75rem
}
.mint-border {
    border-width: 1px
}
.mint-border-gray-100 {
    --tw-border-opacity: 1;
    border-color: rgb(243 244 246 / var(--tw-border-opacity))
}
.\!mint-bg-gray-400\/10 {
    background-color: rgb(156 163 175 / 0.1) !important
}
.mint-bg-gray-500 {
    --tw-bg-opacity: 1;
    background-color: rgb(107 114 128 / var(--tw-bg-opacity))
}
.mint-bg-white\/50 {
    background-color: rgb(255 255 255 / 0.5)
}
.mint-object-cover {
    object-fit: cover
}
.mint-p-4 {
    padding: 1rem
}
.mint-py-2 {
    padding-top: 0.5rem;
    padding-bottom: 0.5rem
}
.mint-pl-3 {
    padding-left: 0.75rem
}
.mint-pr-3 {
    padding-right: 0.75rem
}
.mint-text-center {
    text-align: center
}
.mint-text-lg {
    font-size: 1.125rem;
    line-height: 1.75rem
}
.mint-text-sm {
    font-size: 0.875rem;
    line-height: 1.25rem
}
.mint-font-medium {
    font-weight: 500
}
.mint-font-normal {
    font-weight: 400
}
.mint-font-semibold {
    font-weight: 600
}
.mint-leading-6 {
    line-height: 1.5rem
}
.mint-text-gray-400 {
    --tw-text-opacity: 1;
    color: rgb(156 163 175 / var(--tw-text-opacity))
}
.mint-text-gray-900 {
    --tw-text-opacity: 1;
    color: rgb(17 24 39 / var(--tw-text-opacity))
}
.mint-text-white {
    --tw-text-opacity: 1;
    color: rgb(255 255 255 / var(--tw-text-opacity))
}
.mint-shadow-md {
    --tw-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
    --tw-shadow-colored: 0 4px 6px -1px var(--tw-shadow-color), 0 2px 4px -2px var(--tw-shadow-color);
    box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)
}
.mint-shadow-sm {
    --tw-shadow: 0 1px 2px 0 rgb(0 0 0 / 0.05);
    --tw-shadow-colored: 0 1px 2px 0 var(--tw-shadow-color);
    box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)
}
.mint-shadow-gray-300\/10 {
    --tw-shadow-color: rgb(209 213 219 / 0.1);
    --tw-shadow: var(--tw-shadow-colored)
}
.mint-ring-1 {
    --tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);
    --tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);
    box-shadow: var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow, 0 0 #0000)
}
.mint-ring-2 {
    --tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);
    --tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);
    box-shadow: var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow, 0 0 #0000)
}
.mint-ring-gray-400\/20 {
    --tw-ring-color: rgb(156 163 175 / 0.2)
}
.mint-ring-transparent {
    --tw-ring-color: transparent
}
.hover\:mint-bg-gray-600:hover {
    --tw-bg-opacity: 1;
    background-color: rgb(75 85 99 / var(--tw-bg-opacity))
}
.hover\:mint-ring-gray-600\/25:hover {
    --tw-ring-color: rgb(75 85 99 / 0.25)
}
.dark\:mint-border-gray-800\/50:is(.dark *) {
    border-color: rgb(31 41 55 / 0.5)
}
.dark\:mint-bg-white\/50:is(.dark *) {
    background-color: rgb(255 255 255 / 0.5)
}
.dark\:mint-text-gray-200:is(.dark *) {
    --tw-text-opacity: 1;
    color: rgb(229 231 235 / var(--tw-text-opacity))
}
.dark\:mint-text-white\/50:is(.dark *) {
    color: rgb(255 255 255 / 0.5)
}
.dark\:mint-shadow-none:is(.dark *) {
    --tw-shadow: 0 0 #0000;
    --tw-shadow-colored: 0 0 #0000;
    box-shadow: var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow)
}
.dark\:mint-ring-1:is(.dark *) {
    --tw-ring-offset-shadow: var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);
    --tw-ring-shadow: var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);
    box-shadow: var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow, 0 0 #0000)
}
.dark\:mint-ring-gray-600\/30:is(.dark *) {
    --tw-ring-color: rgb(75 85 99 / 0.3)
}
.dark\:mint-brightness-\[1\.1\]:is(.dark *) {
    --tw-brightness: brightness(1.1);
    filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)
}
.dark\:hover\:mint-bg-white\/70:hover:is(.dark *) {
    background-color: rgb(255 255 255 / 0.7)
}
.dark\:hover\:mint-ring-gray-500\/30:hover:is(.dark *) {
    --tw-ring-color: rgb(107 114 128 / 0.3)
}
.dark\:hover\:mint-brightness-\[1\.25\]:hover:is(.dark *) {
    --tw-brightness: brightness(1.25);
    filter: var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)
}
@media (min-width: 768px) {
    .md\:mint-grid-cols-2 {
        grid-template-columns: repeat(2, minmax(0, 1fr))
    }
}
@media (min-width: 1024px) {
    .lg\:mint-flex {
        display: flex
    }
    .lg\:mint-grid-cols-3 {
        grid-template-columns: repeat(3, minmax(0, 1fr))
    }
}

Platform overview

Developer Apps

Projects

Developer portal

Overview

Authentication

Basic authentication

OAuth FAQ

API reference

OAuth API reference index

Counting characters

Counting characters when composing Tweets

Rate limits

X IDs

Security

Partner Directory

X Official Partner

Customer Directory

Enterprise data customers

Enterprise Access Form

Government End User Request Form

Tools and libraries

Instructions and examples to help you get started.

Tutorials

API Reference Index

Introduction

About the X API

Getting access

How to get access to the X API

Make your first request

Make your first request to the X API

Important resources

SDKs

Data Formation Migration

X API endpoint map

What to build

X API v2 data dictionary

Fields

Expansions

Post Annotations

Metrics

Conversation ID

Pagination

Versioning

Consistency

Edit Posts

Step-by-step guide

Increasing access

Ads API hierarchy and terminology

Accessing Ads accounts

Making Authenticated Requests

Error codes and responses

Rate limiting

Sorting

Versions

Timezones

Currency

Sandbox

Analytics

Audiences

Campaign Management

Catalog Management

Creatives

Mobile Conversions

Web conversions

AB Testing

The user Post timeline and user mention timeline endpoints allow developers to retrieve the public Posts composed by, or mentioning a user.

Explore a user’s Posts

Explore a user’s Posts and mentions with the X API v2

In this tutorial, we will discuss what Postman is and how to quickly get set up with it.

Getting started with Postman

Getting historical Posts using the v2 full-archive search endpoint

Use X's powerful APIs to help your business listen, act, and discover.

Build for businesses

Build for people on X, to enhance and improve their experience on the platform.

Build for the public

Use the X API to get historical and real-time data points for your next research project.

Do research

Teach or learn valuable skills with the X API.

Teach and learn

Build for good

Begin using the X API in seconds with one of our access plans.

Build for fun

The X Developer Platform is updated frequently with new functionality and products to better suit your needs. We will be documenting all changes made to the platform’s products via this resource and the @API X account.

Changelog

Full-archive search

Returns Posts from the last 7 days that match a search query.

Recent search

Returns Post Counts that match a search query.

Full archive search counts

Returns Post Counts from the last 7 days that match a search query.

Recent search counts

Streams Posts matching the stream's active rule set.

Filtered stream

Returns rules from a User's active rule set. Users can fetch all of their rules or a subset, specified by the provided rule ids.

Rules lookup

Returns the counts of rules from a User's active rule set, to reflect usage by project and application.

Rules Count

Add or delete rules from a User's active rule set. Users can provide unique, optionally tagged rules to add. Users can delete their entire rule set or a subset specified by rule ids or values.

Add/Delete rules

The X API v2 has three timelines endpoints - reverse chronological home timeline, user Post timeline, and user mention timeline. See below for more details.

Returns a list of Posts authored by the provided User ID

User Posts timeline by User ID

Returns Post objects that mention username associated to the provided User ID

User mention timeline by User ID

Returns Post objects that appears in the provided User ID's home timeline

User home timeline by User ID

Returns a variety of information about the Post specified by the requested ID.

Post lookup by Post IDs

Post lookup by Post ID

Returns Post objects that have been bookmarked by the requesting User

Bookmarks by User

Adds a Post (ID in the body) to the requesting User's (in the path) bookmarks

Add Post to Bookmarks

Removes a Post from the requesting User's bookmarked Posts.

Remove a bookmarked Post

Causes the User to create a Post under the authorized account.

Creation of a Post

Delete specified Post (in the path) by ID.

Post delete by Post ID

Returns a list of Users that have retweeted the provided Post ID

Returns User objects that have retweeted the provided Post ID

Causes the User (in the path) to repost the specified Post. The User in the path must match the User context authorizing the request.

Causes the User (in the path) to repost the specified Post.

Causes the User (in the path) to unretweet the specified Post. The User must match the User context authorizing the request

Causes the User (in the path) to unretweet the specified Post

Returns a variety of information about each Post that has retweeted the Post specified by the requested ID.

Retrieve Posts that repost a Post.

This endpoint returns reposts of the requesting User.

Returns repost of user

Returns a variety of information about each Post that quotes the Post specified by the requested ID.

Retrieve Posts that quote a Post.

Apps

Hides or unhides a reply to an owned conversation.

Hide replies

Firehose stream

Streams 100% of English Language public Posts.

English Language Firehose stream

Streams 100% of Japanese Language public Posts.

Japanese Language Firehose stream

Streams 100% of Korean Language public Posts.

Korean Language Firehose stream

Streams 100% of Portuguese Language public Posts.

Portuguese Language Firehose stream

Streams a deterministic 1% of public Posts.

Sample stream

Streams a deterministic 10% of public Posts.

Sample 10% stream

This endpoint returns information about a User. Specify User by ID.

User lookup by ID

This endpoint returns information about Users. Specify Users by their ID.

User lookup by IDs

This endpoint returns information about Users. Specify Users by their username.

User lookup by usernames

This endpoint returns information about a User. Specify User by username.

User lookup by username

This endpoint returns information about the requesting User.

User lookup me

User search

Returns a list of Users who are followers of the specified User ID.

Followers by User ID

Returns a list of Users that are being followed by the provided User ID

Following by User ID

Causes the User(in the path) to follow, or “request to follow” for protected Users, the target User. The User(in the path) must match the User context authorizing the request

Follow User

Causes the source User to unfollow the target User. The source User must match the User context authorizing the request

Unfollow User

Causes the User (in the path) to mute the target User. The User (in the path) must match the User context authorizing the request.

Mute User by User ID.

Causes the source User to unmute the target User. The source User must match the User context authorizing the request

Unmute User by User ID

Returns a list of Users that are muted by the provided User ID

Returns User objects that are muted by the provided User ID

Returns a list of Users that are blocked by the provided User ID

Returns User objects that are blocked by provided User ID

Returns Personalized trends for the authenticated user

Get personalized Trends

Get Last 28hr Metrics for Posts

Get Historical Metrics for Posts

Create a new DM Conversation

Delete Dm

Creates a new message for a DM Conversation with a participant user by ID

Send a new message to a user

Creates a new message for a DM Conversation specified by DM Conversation ID

Send a new message to a DM Conversation

Get DM Events for a DM Conversation

Returns recent DM Events across DM conversations

Get recent DM Events

Get DM Events by id

Causes DMs to/from the target User (in the path) to be blocked by the authenticated request user

Causes DMs to/from the target User (in the path) to be unblocked by the authenticated request user

Returns a list of Posts liked by the provided User ID

Returns Post objects liked by the provided User ID

Returns a list of Users that have liked the provided Post ID

Returns User objects that have liked the provided Post ID

Causes the User (in the path) to like the specified Post. The User in the path must match the User context authorizing the request.

Causes the User (in the path) to like the specified Post

Causes the User (in the path) to unlike the specified Post. The User must match the User context authorizing the request

Build for businesses

Build for the public

Do research

Teach & learn

Build for fun

Build for good