post/user/details

User Details

User

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access X data through agntdata: User Details. This endpoint returns the public information about a Twitter profile. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need tweets, user profiles, followers, search, and hashtag streams programmatically.

Use cases

AI agents that need X data in structured form

Analytics and monitoring pipelines for X content

Research and GTM workflows that combine X signals with other data

Parameters

bodyRequest Body

Content type: application/json

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string"
    }
  }
}

Responses

Response

{
  "type": "object",
  "properties": {
    "creation_date": {
      "type": "string"
    },
    "user_id": {
      "type": "string"
    },
    "username": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "follower_count": {
      "type": "integer"
    },
    "following_count": {
      "type": "integer"
    },
    "is_private": {
      "type": "boolean"
    },
    "is_verified": {
      "type": "boolean"
    },
    "location": {
      "type": "string"
    },
    "profile_pic_url": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "external_url": {
      "type": "string"
    },
    "number_of_tweets": {
      "type": "integer"
    },
    "bot": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "integer"
    }
  }
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "User_Details_post__user_details",
  "method": "post",
  "path": "/user/details",
  "summary": "User Details",
  "description": "This endpoint returns the public information about a Twitter profile",
  "parameters": [],
  "requestBody": {
    "required": false,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "username": {
              "type": "string"
            }
          }
        },
        "example": {
          "username": "elonmusk",
          "user_id": "44196397"
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "creation_date": {
                "type": "string"
              },
              "user_id": {
                "type": "string"
              },
              "username": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "follower_count": {
                "type": "integer"
              },
              "following_count": {
                "type": "integer"
              },
              "is_private": {
                "type": "boolean"
              },
              "is_verified": {
                "type": "boolean"
              },
              "location": {
                "type": "string"
              },
              "profile_pic_url": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "external_url": {
                "type": "string"
              },
              "number_of_tweets": {
                "type": "integer"
              },
              "bot": {
                "type": "boolean"
              },
              "timestamp": {
                "type": "integer"
              }
            }
          },
          "example": {
            "creation_date": "Tue Jun 02 20:12:29 +0000 2009",
            "user_id": "44196397",
            "username": "elonmusk",
            "name": "Kekius Maximus",
            "follower_count": 219778553,
            "following_count": 1134,
            "favourites_count": 147042,
            "is_private": null,
            "is_verified": false,
            "is_blue_verified": true,
            "location": "",
            "profile_pic_url": "https://pbs.twimg.com/profile_images/1923451603740168192/bBoBROAs_normal.jpg",
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/1739948056",
            "description": "",
            "external_url": null,
            "number_of_tweets": 78883,
            "bot": false,
            "timestamp": 1243973549,
            "has_nft_avatar": false,
            "category": null,
            "default_profile": false,
            "default_profile_image": false,
            "listed_count": 162327,
            "verified_type": null
          }
        }
      }
    },
    {
      "statusCode": "422",
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "title": "HTTPValidationError",
            "type": "object",
            "properties": {
              "detail": {
                "title": "Detail",
                "type": "array",
                "items": {
                  "title": "ValidationError",
                  "required": [
                    "loc",
                    "msg",
                    "type"
                  ],
                  "type": "object",
                  "properties": {
                    "loc": {
                      "title": "Location",
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "integer"
                          }
                        ]
                      }
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "example": {
            "detail": [
              {
                "loc": [],
                "msg": "",
                "type": ""
              }
            ]
          }
        }
      }
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Start for free

Related endpoints

getUser About

/user/about

getTweet Replies Continuation

/tweet/replies/continuation

postTweet Replies Continuation

/tweet/replies/continuation

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

Get started for free View all endpoints

X APIX data APIuser details APIAI agents data APIX APIX data APIX for AI agents

Back to X (Twitter)