Update Twitter Profile Banner API

Update a Twitter user's profile banner programmatically via API. $0.001 per call. GetXAPI update banner endpoint with image URL or base64 upload.

POST/twitter/user/update_banner

This endpoint costs $0.001 per API call.

Updates the profile banner for the user owning auth_token. Provide the image as a public URL or as base64 — exactly one of the two.

Body Parameters

Parameter	Type	Required	Description
`auth_token`	string	Yes	User's `auth_token` cookie
`image_url`	string	Conditional	Public URL to fetch the image from. Required if `image_base64` is not provided.
`image_base64`	string	Conditional	Raw base64 (with or without `data:image/...;base64,` prefix). Required if `image_url` is not provided.

Notes

Recommended size: 1500×500. Supported formats: JPG, PNG.
Provide exactly one of image_url or image_base64.

Response (200)

{
  "status": "success",
  "msg": "Banner updated successfully",
  "data": { "success": true }
}

Error Responses

400 - Missing fields

{
  "error": "Provide either image_url or image_base64"
}

401 - Invalid auth_token

{
  "error": "Invalid auth_token - could not extract userId"
}

Example

curl --request POST \
  --header "Authorization: Bearer API_KEY" \
  --header "Content-Type: application/json" \
  --url "https://api.getxapi.com/twitter/user/update_banner" \
  --data '{ "auth_token": "<auth_token>", "image_url": "https://example.com/banner.png" }'

Update Banner