twexapi-io Twitter Profile Actions Endpoints API

openapi: 3.2.0
info:
  title: TwexAPI REST Twitter Profile Actions Endpoints API
  description: 'TwexAPI exposes a REST API at `https://api.twexapi.io` for X/Twitter search, profiles, followers, posting, DMs, and agent integrations.


    **Capabilities include:**


    * **Search** — Advanced search, hashtags, cashtags

    * **Tweets** — Post, like, retweet, quote, bookmark, delete

    * **Users** — Batch user information retrieval

    * **Influencers** — Get tweets from top influencers


    All endpoints return a consistent envelope with `code`, `msg`, and `data` fields. See Error Handling for status codes and recovery.


    ## Authentication


    Send your API key on every request:


    ```txt

    Authorization: Bearer YOUR_API_KEY

    ```


    Write actions also require a Twitter cookie or `auth_token`. See Authentication for setup examples.'
  contact:
    name: TwexAPI Support
    email: support@twexapi.io
  license:
    name: MIT
  version: 1.0.0
servers:
- url: https://api.twexapi.io
  description: Development server
tags:
- name: Twitter Profile Actions Endpoints
paths:
  /twitter/profile:
    post:
      tags:
      - Twitter Profile Actions Endpoints
      summary: Modify the profile bio, image and banner of the user
      operationId: modify_profile_bio_endpoint_twitter_profile_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModifyProfileBioRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyProfileBioResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
components:
  schemas:
    ModifyProfileBioRequest:
      properties:
        cookie:
          type: string
          title: Cookie
          description: The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
          description: Name of the user
        website:
          anyOf:
          - type: string
          - type: 'null'
          title: Website
          description: Website of the user
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
          description: Description of the user
        location:
          anyOf:
          - type: string
          - type: 'null'
          title: Location
          description: Location of the user
          example: New York, USA
        profile_image:
          anyOf:
          - type: string
          - type: 'null'
          title: Profile Image
          description: Profile image of the user
          example: https://example.com/image.jpg
        profile_banner:
          anyOf:
          - type: string
          - type: 'null'
          title: Profile Banner
          description: Profile banner of the user
          example: https://example.com/banner.jpg
        proxy:
          anyOf:
          - type: string
          - type: 'null'
          title: Proxy
          description: 'The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://app.proxy-cheap.com/r/qiMxub'
          example: http://username:password@ip:port
      type: object
      required:
      - cookie
      title: ModifyProfileBioRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ModifyProfileBioResponse:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code (200 for success)
          example: 200
        msg:
          type: string
          title: Msg
          description: Human-readable response message
          example: success
        data:
          type: boolean
          title: Data
          description: True if the profile bio, image and banner are modified successfully, False otherwise
          example: true
      type: object
      required:
      - code
      - msg
      - data
      title: ModifyProfileBioResponse
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer