> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-04d20e4e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Follows endpoints migration overview

> Migrate followers, following, and follow management from Standard v1.1 friendships endpoints to the X API v2 follows endpoints with mapped parameters.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

## Comparing X API’s follows endpoints

### Follows lookup

The v2 follows lookup endpoints will replace the standard v1.1 [followers/ids](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-followers-ids), v1.1 [followers/list](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-followers-list), v1.1 [friends/ids](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-friends-ids), and v1.1 [friends/list](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-friends-list) endpoints.

The following tables compare the various types of follows lookup endpoints:

|                                                                                                                                                                    |                                                                                                                                                                                              |                                                                                                                                                                                                                                                                                                                                                       |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description**                                                                                                                                                    | **Standard v1.1**                                                                                                                                                                            | **X API v2**                                                                                                                                                                                                                                                                                                                                          |
| HTTP methods supported                                                                                                                                             | `GET`                                                                                                                                                                                        | `GET`                                                                                                                                                                                                                                                                                                                                                 |
| Host domain                                                                                                                                                        | `https://api.x.com`                                                                                                                                                                          | `https://api.x.com`                                                                                                                                                                                                                                                                                                                                   |
| Endpoint path                                                                                                                                                      | /1.1/friends/ids.json<br /><br />/1.1/friends/list.json<br /><br />/1.1/followers/ids.json<br /><br />/1.1/followers/list.json                                                               | /2/users/:id/following<br /><br />/2/users/:id/followers                                                                                                                                                                                                                                                                                              |
| [Authentication](/resources/fundamentals/authentication)                                                                                                           | OAuth 1.0a User Context<br /><br />App only                                                                                                                                                  | OAuth 1.0a User Context<br /><br />OAuth 2.0 Authorization Code with PKCE<br /><br />App only                                                                                                                                                                                                                                                         |
| Default request [rate limits](/resources/fundamentals/rate-limits)                                                                                                 | 15 requests per 15 min (per user)<br /><br />15 requests per 15 min (per app)                                                                                                                | 15 requests per 15 min (per user)<br /><br />15 requests per 15 min (per app)                                                                                                                                                                                                                                                                         |
| Maximum users per response                                                                                                                                         | GET friends/id & GET followers/id return a maximum of 5000 users IDs per page.<br /><br />  <br /><br />GET friends/list & GET followers/list return a maximum of 200 user objects per page. | 1000 user objects per page                                                                                                                                                                                                                                                                                                                            |
| Pagination                                                                                                                                                         | Token returns in a next\_cursor field, which can then be passed as the value to the cursor parameter to return the next page of results.                                                     | Token returns in a next\_token field, which can then be passed as the value to the token parameter to return the next page of results.<br /><br />The v2 payload also delivers a previous\_token field, which can also be passed with the pagination\_token parameter to return the previous page of results.                                         |
| JSON format                                                                                                                                                        | Standard v1.1 format                                                                                                                                                                         | [X API v2 format](/x-api/fundamentals/data-dictionary) (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats)<br /><br />To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our [data formats migration guide](/x-api/migrate/data-format-migration). |
| Supports selecting which [fields](/x-api/fundamentals/data-dictionary) return in the payload                                                                       |                                                                                                                                                                                              | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports the Post [annotations](/x-api/fundamentals/post-annotations) fields                                                                                       |                                                                                                                                                                                              | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports requesting new [metrics](/x-api/fundamentals/metrics) fields                                                                                              |                                                                                                                                                                                              | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Supports the [conversation\_id](/x-api/fundamentals/conversation-id) field                                                                                         |                                                                                                                                                                                              | ✔                                                                                                                                                                                                                                                                                                                                                     |
| Requires the use of credentials from a [developer App](/resources/fundamentals/developer-apps) associated with a [project](/resources/fundamentals/developer-apps) |                                                                                                                                                                                              | ✔                                                                                                                                                                                                                                                                                                                                                     |

#### Manage follows

The v2 manage follows endpoints will replace the standard v1.1 [POST friendships/create](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/post-friendships-create) and [POST friendships/destroy](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/follow-search-get-users/api-reference/post-friendships-destroy) endpoints.

The following tables compare the standard v1.1 and X API v2 create follow endpoints:

#### Follow a user

| Description                                                                                                                                                            | Standard v1.1                          | X API v2                                                                  |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------- | :------------------------------------------------------------------------ |
| HTTP methods supported                                                                                                                                                 | POST                                   | POST                                                                      |
| Host domain                                                                                                                                                            | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com)                                    |
| Endpoint path                                                                                                                                                          | /1.1/friendships/create.json           | /2/users/:id/following                                                    |
| [Authentication](/resources/fundamentals/authentication)                                                                                                               | OAuth 1.0a User Context                | OAuth 1.0a User Context<br /><br />OAuth 2.0 Authorization Code with PKCE |
| Default request [rate limits](/resources/fundamentals/rate-limits)                                                                                                     | 50 requests per 15 min                 | 50 requests per 15 min                                                    |
| Maximum daily operations per users                                                                                                                                     | 400                                    | 400                                                                       |
| Maximum daily operations per app                                                                                                                                       | 1000                                   | 1000                                                                      |
| Requires use of credentials from a [developer App](/resources/fundamentals/developer-apps) that is associated with a [Project](/resources/fundamentals/developer-apps) |                                        | ✔️                                                                        |

#### Unfollow a user

The following tables compare the standard v1.1 and X API v2 delete follow endpoints:

| Description                                                                                                                                                            | Standard v1.1                          | X API v2                                                                  |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------- | :------------------------------------------------------------------------ |
| HTTP methods supported                                                                                                                                                 | POST                                   | DELETE                                                                    |
| Host domain                                                                                                                                                            | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com)                                    |
| Endpoint path                                                                                                                                                          | /1.1/friendships/destroy.json          | /2/users/:source\_user\_id/following/:target\_user\_id                    |
| [Authentication](/resources/fundamentals/authentication)                                                                                                               | OAuth 1.0a User Context                | OAuth 1.0a User Context<br /><br />OAuth 2.0 Authorization Code with PKCE |
| Default request [rate limits](/resources/fundamentals/rate-limits)                                                                                                     | 15 requests per 15 min (per user)      | 50 requests per 15 min (per user)                                         |
| Maximum daily operations per app                                                                                                                                       | None                                   | 500                                                                       |
| Requires use of credentials from a [developer App](/resources/fundamentals/developer-apps) that is associated with a [Project](/resources/fundamentals/developer-apps) |                                        | ✔️                                                                        |

**Other migration resources**

[Follows lookup: Standard v1.1 to X API v2](/x-api/users/follows/migrate/standard-to-twitter-api-v2)

[Manage follows: Standard v1.1 to X API v2](/x-api/users/follows#manage-follows-standard-v1-1-compared-to-x-api-v2)

[X API migration hub](/x-api/migrate/overview)