X posts API

3 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

POST/v1/orgs/{orgId}/marketing/x-posts/delete

Bearer tokenMCP tool: delete_x_post

Deletes one of the workspace's own X posts, named by its link on X or by its post id. A published post is deleted on X and removed here; one that hasn't gone out yet is canceled.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• postUrlstring
• postIdstring (uuid)
• socialAccountIdstring (uuid)

Responses

200Deletes one of the workspace's own X posts, named by its link on X or by its post id. A published post is deleted on X and removed here; one that hasn't gone out yet is canceled.

• dataobjectrequired
  Fields

  • outcomestringrequired

    one of deleted_on_x, removed_from_schedule

  • postIdstring | nullrequired
  • xPostIdstring | nullrequired
  • socialAccountIdstring | nullrequired
  • warningsarray<string>required

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/x-posts/delete" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST/v1/orgs/{orgId}/marketing/x-posts/read

Bearer tokenMCP tool: get_x_post

Reads any public post on X by its link or id: full text, author, metrics, links, hashtags, mentions and the posts it replies to or quotes, plus its photos and videos when asked. Each post X returns costs usage credits.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• poststringrequired
• includeMediaboolean

Responses

200Reads any public post on X by its link or id: full text, author, metrics, links, hashtags, mentions and the posts it replies to or quotes, plus its photos and videos when asked. Each post X returns costs usage credits.

• dataobjectrequired
  Fields

  • postobjectrequired
    Fields

    • idstringrequired
    • urlstringrequired
    • textstringrequired
    • createdAtstring | nullrequired
    • langstring | nullrequired
    • authorobject | nullrequired
      Fields

      • idstringrequired
      • handlestring | nullrequired
      • namestring | nullrequired
      • verifiedbooleanrequired
      • followersnumber | nullrequired
      • profileImageUrlstring | nullrequired
      • biostring | nullrequired
    • metricsobjectrequired
      Fields

      • likesnumberrequired
      • repostsnumberrequired
      • repliesnumberrequired
      • quotesnumberrequired
      • bookmarksnumberrequired
      • impressionsnumber | nullrequired
    • conversationIdstring | nullrequired
    • inReplyToPostIdstring | nullrequired
    • linksarray<object>required
      Item fields

      • urlstringrequired
      • expandedUrlstring | nullrequired
      • titlestring | nullrequired
      • descriptionstring | nullrequired
    • hashtagsarray<string>required
    • mentionsarray<string>required
    • cashtagsarray<string>required
    • possiblySensitivebooleanrequired
    • mediaCountnumberrequired
    • mediaarray<object>required
      Item fields

      • keystringrequired
      • typestringrequired

        one of photo, video, animated_gif

      • urlstring | nullrequired
      • previewImageUrlstring | nullrequired
      • altTextstring | nullrequired
      • widthnumber | nullrequired
      • heightnumber | nullrequired
      • durationMsnumber | nullrequired
      • variantsarray<object>required
        Item fields

        • urlstringrequired
        • contentTypestringrequired
        • bitRatenumber | nullrequired
    • referencedPostsarray<object>required
      Item fields

      • typestringrequired

        one of replied_to, quoted, retweeted

      • idstringrequired
      • postobject | nullrequired
        Fields

        • idstringrequired
        • urlstringrequired
        • textstringrequired
        • createdAtanyrequired
        • langanyrequired
        • authoranyrequired
        • metricsobjectrequired
          Fields

          • likesnumberrequired
          • repostsnumberrequired
          • repliesnumberrequired
          • quotesnumberrequired
          • bookmarksnumberrequired
          • impressionsnumber | nullrequired
        • conversationIdanyrequired
        • inReplyToPostIdanyrequired
        • linksarray<object>required
          Item fields

          • urlstringrequired
          • expandedUrlstring | nullrequired
          • titlestring | nullrequired
          • descriptionstring | nullrequired
        • hashtagsarray<string>required
        • mentionsarray<string>required
        • cashtagsarray<string>required
        • possiblySensitivebooleanrequired
        • mediaCountnumberrequired
        • mediaarray<object>required
          Item fields

          • keystringrequired
          • typestringrequired

            one of photo, video, animated_gif

          • urlstring | nullrequired
          • previewImageUrlstring | nullrequired
          • altTextstring | nullrequired
          • widthnumber | nullrequired
          • heightnumber | nullrequired
          • durationMsnumber | nullrequired
          • variantsarray<object>required
  • usageobjectrequired
    Fields

    • postsReturnednumberrequired
    • postsChargednumberrequired
    • creditsUsednumberrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/x-posts/read" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"post":"string"}'

POST/v1/orgs/{orgId}/marketing/x-posts/thread

Bearer tokenMCP tool: get_x_thread

Reads the conversation a post on X belongs to: the post that started it, the author's own thread oldest first and, when asked, other people's replies. Each post X returns costs usage credits.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• poststringrequired
• includeRepliesboolean
• includeMediaboolean
• limitinteger

Responses

200Reads the conversation a post on X belongs to: the post that started it, the author's own thread oldest first and, when asked, other people's replies. Each post X returns costs usage credits.

• dataobjectrequired
  Fields

  • postobjectrequired
    Fields

    • idstringrequired
    • urlstringrequired
    • textstringrequired
    • createdAtstring | nullrequired
    • langstring | nullrequired
    • authorobject | nullrequired
      Fields

      • idstringrequired
      • handlestring | nullrequired
      • namestring | nullrequired
      • verifiedbooleanrequired
      • followersnumber | nullrequired
      • profileImageUrlstring | nullrequired
      • biostring | nullrequired
    • metricsobjectrequired
      Fields

      • likesnumberrequired
      • repostsnumberrequired
      • repliesnumberrequired
      • quotesnumberrequired
      • bookmarksnumberrequired
      • impressionsnumber | nullrequired
    • conversationIdstring | nullrequired
    • inReplyToPostIdstring | nullrequired
    • linksarray<object>required
      Item fields

      • urlstringrequired
      • expandedUrlstring | nullrequired
      • titlestring | nullrequired
      • descriptionstring | nullrequired
    • hashtagsarray<string>required
    • mentionsarray<string>required
    • cashtagsarray<string>required
    • possiblySensitivebooleanrequired
    • mediaCountnumberrequired
    • mediaarray<object>required
      Item fields

      • keystringrequired
      • typestringrequired

        one of photo, video, animated_gif

      • urlstring | nullrequired
      • previewImageUrlstring | nullrequired
      • altTextstring | nullrequired
      • widthnumber | nullrequired
      • heightnumber | nullrequired
      • durationMsnumber | nullrequired
      • variantsarray<object>required
        Item fields

        • urlstringrequired
        • contentTypestringrequired
        • bitRatenumber | nullrequired
    • referencedPostsarray<object>required
      Item fields

      • typestringrequired

        one of replied_to, quoted, retweeted

      • idstringrequired
      • postobject | nullrequired
        Fields

        • idstringrequired
        • urlstringrequired
        • textstringrequired
        • createdAtanyrequired
        • langanyrequired
        • authoranyrequired
        • metricsobjectrequired
          Fields

          • likesnumberrequired
          • repostsnumberrequired
          • repliesnumberrequired
          • quotesnumberrequired
          • bookmarksnumberrequired
          • impressionsnumber | nullrequired
        • conversationIdanyrequired
        • inReplyToPostIdanyrequired
        • linksarray<object>required
          Item fields

          • urlstringrequired
          • expandedUrlstring | nullrequired
          • titlestring | nullrequired
          • descriptionstring | nullrequired
        • hashtagsarray<string>required
        • mentionsarray<string>required
        • cashtagsarray<string>required
        • possiblySensitivebooleanrequired
        • mediaCountnumberrequired
        • mediaarray<object>required
          Item fields

          • keystringrequired
          • typestringrequired

            one of photo, video, animated_gif

          • urlstring | nullrequired
          • previewImageUrlstring | nullrequired
          • altTextstring | nullrequired
          • widthnumber | nullrequired
          • heightnumber | nullrequired
          • durationMsnumber | nullrequired
          • variantsarray<object>required
  • rootobject | nullrequired
    Fields

    • idstringrequired
    • urlstringrequired
    • textstringrequired
    • createdAtstring | nullrequired
    • langstring | nullrequired
    • authorobject | nullrequired
      Fields

      • idstringrequired
      • handlestring | nullrequired
      • namestring | nullrequired
      • verifiedbooleanrequired
      • followersnumber | nullrequired
      • profileImageUrlstring | nullrequired
      • biostring | nullrequired
    • metricsobjectrequired
      Fields

      • likesnumberrequired
      • repostsnumberrequired
      • repliesnumberrequired
      • quotesnumberrequired
      • bookmarksnumberrequired
      • impressionsnumber | nullrequired
    • conversationIdstring | nullrequired
    • inReplyToPostIdstring | nullrequired
    • linksarray<object>required
      Item fields

      • urlstringrequired
      • expandedUrlstring | nullrequired
      • titlestring | nullrequired
      • descriptionstring | nullrequired
    • hashtagsarray<string>required
    • mentionsarray<string>required
    • cashtagsarray<string>required
    • possiblySensitivebooleanrequired
    • mediaCountnumberrequired
    • mediaarray<object>required
      Item fields

      • keystringrequired
      • typestringrequired

        one of photo, video, animated_gif

      • urlstring | nullrequired
      • previewImageUrlstring | nullrequired
      • altTextstring | nullrequired
      • widthnumber | nullrequired
      • heightnumber | nullrequired
      • durationMsnumber | nullrequired
      • variantsarray<object>required
        Item fields

        • urlstringrequired
        • contentTypestringrequired
        • bitRatenumber | nullrequired
    • referencedPostsarray<object>required
      Item fields

      • typestringrequired

        one of replied_to, quoted, retweeted

      • idstringrequired
      • postobject | nullrequired
        Fields

        • idstringrequired
        • urlstringrequired
        • textstringrequired
        • createdAtanyrequired
        • langanyrequired
        • authoranyrequired
        • metricsobjectrequired
          Fields

          • likesnumberrequired
          • repostsnumberrequired
          • repliesnumberrequired
          • quotesnumberrequired
          • bookmarksnumberrequired
          • impressionsnumber | nullrequired
        • conversationIdanyrequired
        • inReplyToPostIdanyrequired
        • linksarray<object>required
          Item fields

          • urlstringrequired
          • expandedUrlstring | nullrequired
          • titlestring | nullrequired
          • descriptionstring | nullrequired
        • hashtagsarray<string>required
        • mentionsarray<string>required
        • cashtagsarray<string>required
        • possiblySensitivebooleanrequired
        • mediaCountnumberrequired
        • mediaarray<object>required
          Item fields

          • keystringrequired
          • typestringrequired

            one of photo, video, animated_gif

          • urlstring | nullrequired
          • previewImageUrlstring | nullrequired
          • altTextstring | nullrequired
          • widthnumber | nullrequired
          • heightnumber | nullrequired
          • durationMsnumber | nullrequired
          • variantsarray<object>required
  • threadarray<object>required
    Item fields

    • idstringrequired
    • urlstringrequired
    • textstringrequired
    • createdAtstring | nullrequired
    • langstring | nullrequired
    • authorobject | nullrequired
      Fields

      • idstringrequired
      • handlestring | nullrequired
      • namestring | nullrequired
      • verifiedbooleanrequired
      • followersnumber | nullrequired
      • profileImageUrlstring | nullrequired
      • biostring | nullrequired
    • metricsobjectrequired
      Fields

      • likesnumberrequired
      • repostsnumberrequired
      • repliesnumberrequired
      • quotesnumberrequired
      • bookmarksnumberrequired
      • impressionsnumber | nullrequired
    • conversationIdstring | nullrequired
    • inReplyToPostIdstring | nullrequired
    • linksarray<object>required
      Item fields

      • urlstringrequired
      • expandedUrlstring | nullrequired
      • titlestring | nullrequired
      • descriptionstring | nullrequired
    • hashtagsarray<string>required
    • mentionsarray<string>required
    • cashtagsarray<string>required
    • possiblySensitivebooleanrequired
    • mediaCountnumberrequired
    • mediaarray<object>required
      Item fields

      • keystringrequired
      • typestringrequired

        one of photo, video, animated_gif

      • urlstring | nullrequired
      • previewImageUrlstring | nullrequired
      • altTextstring | nullrequired
      • widthnumber | nullrequired
      • heightnumber | nullrequired
      • durationMsnumber | nullrequired
      • variantsarray<object>required
        Item fields

        • urlstringrequired
        • contentTypestringrequired
        • bitRatenumber | nullrequired
    • referencedPostsarray<object>required
      Item fields

      • typestringrequired

        one of replied_to, quoted, retweeted

      • idstringrequired
      • postobject | nullrequired
        Fields

        • idstringrequired
        • urlstringrequired
        • textstringrequired
        • createdAtanyrequired
        • langanyrequired
        • authoranyrequired
        • metricsobjectrequired
          Fields

          • likesnumberrequired
          • repostsnumberrequired
          • repliesnumberrequired
          • quotesnumberrequired
          • bookmarksnumberrequired
          • impressionsnumber | nullrequired
        • conversationIdanyrequired
        • inReplyToPostIdanyrequired
        • linksarray<object>required
          Item fields

          • urlstringrequired
          • expandedUrlstring | nullrequired
          • titlestring | nullrequired
          • descriptionstring | nullrequired
        • hashtagsarray<string>required
        • mentionsarray<string>required
        • cashtagsarray<string>required
        • possiblySensitivebooleanrequired
        • mediaCountnumberrequired
        • mediaarray<object>required
          Item fields

          • keystringrequired
          • typestringrequired

            one of photo, video, animated_gif

          • urlstring | nullrequired
          • previewImageUrlstring | nullrequired
          • altTextstring | nullrequired
          • widthnumber | nullrequired
          • heightnumber | nullrequired
          • durationMsnumber | nullrequired
          • variantsarray<object>required
  • repliesarray<object>required
    Item fields

    • idstringrequired
    • urlstringrequired
    • textstringrequired
    • createdAtstring | nullrequired
    • langstring | nullrequired
    • authorobject | nullrequired
      Fields

      • idstringrequired
      • handlestring | nullrequired
      • namestring | nullrequired
      • verifiedbooleanrequired
      • followersnumber | nullrequired
      • profileImageUrlstring | nullrequired
      • biostring | nullrequired
    • metricsobjectrequired
      Fields

      • likesnumberrequired
      • repostsnumberrequired
      • repliesnumberrequired
      • quotesnumberrequired
      • bookmarksnumberrequired
      • impressionsnumber | nullrequired
    • conversationIdstring | nullrequired
    • inReplyToPostIdstring | nullrequired
    • linksarray<object>required
      Item fields

      • urlstringrequired
      • expandedUrlstring | nullrequired
      • titlestring | nullrequired
      • descriptionstring | nullrequired
    • hashtagsarray<string>required
    • mentionsarray<string>required
    • cashtagsarray<string>required
    • possiblySensitivebooleanrequired
    • mediaCountnumberrequired
    • mediaarray<object>required
      Item fields

      • keystringrequired
      • typestringrequired

        one of photo, video, animated_gif

      • urlstring | nullrequired
      • previewImageUrlstring | nullrequired
      • altTextstring | nullrequired
      • widthnumber | nullrequired
      • heightnumber | nullrequired
      • durationMsnumber | nullrequired
      • variantsarray<object>required
        Item fields

        • urlstringrequired
        • contentTypestringrequired
        • bitRatenumber | nullrequired
    • referencedPostsarray<object>required
      Item fields

      • typestringrequired

        one of replied_to, quoted, retweeted

      • idstringrequired
      • postobject | nullrequired
        Fields

        • idstringrequired
        • urlstringrequired
        • textstringrequired
        • createdAtanyrequired
        • langanyrequired
        • authoranyrequired
        • metricsobjectrequired
          Fields

          • likesnumberrequired
          • repostsnumberrequired
          • repliesnumberrequired
          • quotesnumberrequired
          • bookmarksnumberrequired
          • impressionsnumber | nullrequired
        • conversationIdanyrequired
        • inReplyToPostIdanyrequired
        • linksarray<object>required
          Item fields

          • urlstringrequired
          • expandedUrlstring | nullrequired
          • titlestring | nullrequired
          • descriptionstring | nullrequired
        • hashtagsarray<string>required
        • mentionsarray<string>required
        • cashtagsarray<string>required
        • possiblySensitivebooleanrequired
        • mediaCountnumberrequired
        • mediaarray<object>required
          Item fields

          • keystringrequired
          • typestringrequired

            one of photo, video, animated_gif

          • urlstring | nullrequired
          • previewImageUrlstring | nullrequired
          • altTextstring | nullrequired
          • widthnumber | nullrequired
          • heightnumber | nullrequired
          • durationMsnumber | nullrequired
          • variantsarray<object>required
  • truncatedbooleanrequired
  • notesarray<string>required
  • usageobjectrequired
    Fields

    • postsReturnednumberrequired
    • postsChargednumberrequired
    • creditsUsednumberrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/x-posts/thread" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"post":"string"}'