Skip to content
DataXAPI
All X APIs
Accounts & creatorsX (Twitter / 推特)User · Batch Detail

X batch user detail

Read public profiles for up to 100 X user IDs in input order.

POST/v1/x/users/batch-detail

Chinese name: X 用户批量资料 · 用户 · 批量详情 一次按输入顺序读取最多 100 个 X 用户 ID 的公开资料。
x.users.batch.detail@v1

Price per call

¥0.01/ call

Complete and empty results are charged; partial results and failures are not.

Current statusAvailableChecking live status →
Checking live status

Try it

Sign in and run one real call. The result and charge appear right here.

Security check

Loading the security check…

Checking live execution status…

Execution result

// Result

Request parameters

user_idsarrayrequired

minItems: 1 · maxItems: 100

Example: ["4398626122","44196397"]

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "user_ids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9]{1,20}$"
      }
    }
  },
  "required": [
    "user_ids"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/x/users/batch-detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"user_ids":["4398626122","44196397"]}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_x_users_batch_detail",
  "message": "success",
  "data": {
    "items": [
      {
        "id": "4398626122",
        "username": "OpenAI",
        "name": "OpenAI",
        "description": "Public fixture profile",
        "location": "San Francisco",
        "avatar_url": "https://pbs.twimg.com/profile_images/openai.jpg",
        "header_url": "https://pbs.twimg.com/profile_banners/openai.jpg",
        "created_at": "Thu Dec 10 01:03:29 +0000 2015",
        "verified": true,
        "verified_type": null,
        "followers_count": 4000000,
        "following_count": 4,
        "posts_count": 8000,
        "media_count": 1000
      }
    ],
    "missing_user_ids": [
      "44196397"
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [
    "some_users_unavailable"
  ],
  "meta": {
    "listing_id": "x.users.batch.detail",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "partial",
    "charged_amount": "0",
    "balance_after": "1.00",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "username": {
                "type": "string"
              },
              "name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "location": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "header_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "created_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "verified": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "verified_type": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "followers_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "following_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "posts_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "media_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "username",
              "name",
              "description",
              "location",
              "avatar_url",
              "header_url",
              "created_at",
              "verified",
              "verified_type",
              "followers_count",
              "following_count",
              "posts_count",
              "media_count"
            ],
            "additionalProperties": false
          }
        },
        "missing_user_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[0-9]{1,20}$"
          }
        }
      },
      "required": [
        "items",
        "missing_user_ids"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "x.users.batch.detail"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use this for the matching public X workflow.

Not for

  • Do not use it for private data, exhaustive archives, or representative audience claims.

Known limitations

  • Each request accepts at most 100 unique numeric user IDs.
  • Unreturned input IDs are listed explicitly under missing_user_ids.
  • The price is fixed per call regardless of how many user IDs are sent; profiles are point-in-time snapshots.

Billing

¥0.01 per call. Complete and empty results are charged; partial results and failures are not.

See all pricing →