get/user/details

User's Details

User

API Reference & Playground Get started for free

Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Access TikTok data through agntdata: User's Details. Return User Details. Responses are structured JSON for AI agents, analytics, and automation — one API key instead of juggling upstream accounts. Ideal when you need video details, creator profiles, and search across accounts and videos programmatically.

Use cases

AI agents that need TikTok data in structured form

Analytics and monitoring pipelines for TikTok content

Research and GTM workflows that combine TikTok signals with other data

Parameters

Name	In	Type	Required	Description
username	query	string	required	—Default: `mrbeast`

Responses

Successful Response

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string"
    },
    "user_id": {
      "type": "string"
    },
    "profile_image": {
      "type": "string"
    },
    "following": {
      "type": "integer"
    },
    "followers": {
      "type": "integer"
    },
    "total_videos": {
      "type": "integer"
    },
    "total_heart": {
      "type": "integer"
    },
    "verified": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    }
  }
}

Agent / Developer Schema

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

{
  "operationId": "User_s_Details",
  "method": "get",
  "path": "/user/details",
  "summary": "User's Details",
  "description": "Return User Details",
  "parameters": [
    {
      "name": "username",
      "in": "query",
      "required": true,
      "schema": {
        "type": "string",
        "default": "mrbeast"
      }
    }
  ],
  "responses": [
    {
      "statusCode": "200",
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "username": {
                "type": "string"
              },
              "user_id": {
                "type": "string"
              },
              "profile_image": {
                "type": "string"
              },
              "following": {
                "type": "integer"
              },
              "followers": {
                "type": "integer"
              },
              "total_videos": {
                "type": "integer"
              },
              "total_heart": {
                "type": "integer"
              },
              "verified": {
                "type": "boolean"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "example": {
            "username": "mrbeast",
            "user_id": "6614519312189947909",
            "profile_image": "https://p19-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/54435a1ec165931f60f2a3872de74aa5~c5_1080x1080.jpeg?x-expires=1664816400&x-signature=JoBKISbZ5pjbPTw7q6%2FVzJK5wn8%3D",
            "following": 241,
            "followers": 46300000,
            "total_videos": 249,
            "total_heart": 487600000,
            "verified": true,
            "description": "apply :)"
          }
        }
      }
    },
    {
      "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": {
                        "type": "string"
                      }
                    },
                    "msg": {
                      "title": "Message",
                      "type": "string"
                    },
                    "type": {
                      "title": "Error Type",
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "example": {
            "detail": [
              {
                "loc": [],
                "msg": "",
                "type": ""
              }
            ]
          }
        }
      }
    }
  ]
}