Skip to main content
GET
/
v1
/
twitter
/
ListDetails
cURL
curl --request GET \
  --url 'https://api.keyapi.ai/v1/twitter/ListDetails?list_id=1234567890' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "code": 0,
  "message": "success",
  "data": {
    "data": {
      "list": {
        "created_at": 1624162887000,
        "custom_banner_media": {
          "media_info": {
            "original_img_height": 500,
            "original_img_url": "https://pbs.twimg.com/list_banner_img/1406468758978195458/nPbQVIV9?format=jpg&name=orig",
            "original_img_width": 1500,
            "salient_rect": {
              "height": 1,
              "left": 766,
              "top": 250,
              "width": 1
            }
          }
        },
        "custom_banner_media_results": {
          "result": {
            "__typename": "ApiMedia",
            "id": "QXBpTWVkaWE6DAAICgABE4TH4m6UcAIAAA==",
            "media_id": "1406468758978195458",
            "media_info": {
              "__typename": "ApiImage",
              "color_info": {
                "palette": [
                  {
                    "percentage": 98.51,
                    "rgb": {
                      "blue": 199,
                      "green": 73,
                      "red": 85
                    }
                  },
                  {
                    "percentage": 1.11,
                    "rgb": {
                      "blue": 233,
                      "green": 183,
                      "red": 187
                    }
                  },
                  {
                    "percentage": 0.31,
                    "rgb": {
                      "blue": 223,
                      "green": 153,
                      "red": 160
                    }
                  }
                ]
              },
              "original_img_height": 500,
              "original_img_url": "https://pbs.twimg.com/list_banner_img/1406468758978195458/nPbQVIV9?format=jpg&name=orig",
              "original_img_width": 1500,
              "salient_rect": {
                "height": 1,
                "left": 766,
                "top": 250,
                "width": 1
              }
            },
            "media_key": "32_1406468758978195458"
          }
        },
        "default_banner_media": {
          "media_info": {
            "original_img_height": 375,
            "original_img_url": "https://pbs.twimg.com/media/GkIQIQYWEAAgrG9.png",
            "original_img_width": 1125,
            "salient_rect": {
              "height": 1,
              "left": 562,
              "top": 187,
              "width": 1
            }
          }
        },
        "default_banner_media_results": {},
        "description": "Turning Big Ideas into Flagship Digital Products.",
        "facepile_urls": [
          "https://pbs.twimg.com/profile_images/1874092567370887168/dwLUWCOb_mini.jpg",
          "https://pbs.twimg.com/profile_images/2044783844210159617/6r5jGkl3_mini.jpg",
          "https://pbs.twimg.com/profile_images/2040067697715875840/eYngFh4x_mini.jpg"
        ],
        "followers_context": "742 followers including @mdjunaidap",
        "following": false,
        "id": "TGlzdDoxNDA2NDY3MjA0MDk5NDExOTc4",
        "id_str": "1406467204099411978",
        "is_member": false,
        "member_count": 20,
        "members_context": "20 members",
        "mode": "Public",
        "muting": false,
        "name": "10x Content Creators",
        "pinning": false,
        "subscriber_count": 742,
        "user_results": {
          "result": {
            "__typename": "User",
            "affiliates_highlighted_label": {},
            "has_graduated_access": true,
            "id": "VXNlcjo2NDU5MjMyMQ==",
            "is_blue_verified": true,
            "legacy": {
              "blocked_by": false,
              "blocking": false,
              "can_dm": true,
              "can_media_tag": false,
              "created_at": "Tue Aug 11 02:06:10 +0000 2009",
              "default_profile": false,
              "default_profile_image": false,
              "description": "Helping @Shopify partners grow.",
              "entities": {
                "description": {}
              },
              "fast_followers_count": 0,
              "favourites_count": 1498,
              "follow_request_sent": false,
              "followed_by": false,
              "followers_count": 3591,
              "following": false,
              "friends_count": 382,
              "has_custom_timelines": true,
              "is_translator": false,
              "listed_count": 126,
              "location": "United States",
              "media_count": 185,
              "muting": false,
              "name": "mark",
              "needs_phone_verification": false,
              "normal_followers_count": 3591,
              "notifications": false,
              "pinned_tweet_ids_str": [
                "1984293438053908747"
              ],
              "possibly_sensitive": false,
              "profile_banner_url": "https://pbs.twimg.com/profile_banners/64592321/1762240618",
              "profile_image_url_https": "https://pbs.twimg.com/profile_images/1925687866090221568/HWfL2cyG_normal.jpg",
              "profile_interstitial_type": "",
              "protected": false,
              "screen_name": "marktanft",
              "statuses_count": 1256,
              "time_zone": "",
              "translator_type": "none",
              "url": "",
              "utc_offset": 0,
              "verified": false,
              "want_retweets": false,
              "withheld_description": "",
              "withheld_scope": ""
            },
            "parody_commentary_fan_label": "None",
            "professional": {
              "category": [
                {
                  "icon_name": "IconBriefcaseStroke",
                  "id": 724,
                  "name": "Internet Company"
                }
              ],
              "professional_type": "Creator",
              "rest_id": "1455745422358499335"
            },
            "profile_image_shape": "Circle",
            "rest_id": "64592321",
            "super_follow_eligible": false,
            "super_followed_by": false,
            "super_following": false,
            "tipjar_settings": {
              "cash_app_handle": "mjltan",
              "is_enabled": true,
              "venmo_handle": "mark_tan"
            }
          }
        }
      }
    },
    "errors": [
      {
        "code": 214,
        "extensions": {
          "code": 214,
          "kind": "Validation",
          "name": "BadRequestError",
          "source": "Client"
        },
        "kind": "Validation",
        "message": "BadRequest: com.twitter.strato.serialization.DecodeException",
        "name": "BadRequestError",
        "path": [
          "list",
          "default_banner_media_results",
          "result"
        ],
        "source": "Client"
      }
    ]
  },
  "requestId": "da567eb8-2e2f-44b7-964e-65f6763264df"
}

Documentation Index

Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

πŸͺ™1 creditper request

Copy for AI

πŸ€– Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

list_id
string
required

List ID

Example:

"1406467204099411978"

Response

The response is of type object.