Search Endpoints

Search Paid Partnership Tweets

Scan recent tweets by screen_name and return only this author’s non-retweet posts explicitly marked is_paid_promotion=true. Scans up to max_pages search pages (up to 20 tweets requested per page), subject to available quota. This is a bounded scan, not a complete historical export or inferred sponsorship detection. An empty data array can still have has_next_page=true; continue with next_cursor. Missing disclosure flags are excluded and counted in disclosure_unknown_count. No X cookie is required.

post/twitter/search/paid_partnerships

Request

  • Base URL: https://api.twexapi.io
  • URL: https://api.twexapi.io/twitter/search/paid_partnerships
  • Auth: HTTP bearer

Request body

screen_namestring required

Username with or without @; profile URLs are not accepted.

max_pagesinteger nullable

Maximum search pages to scan: an integer from 1 to 5, not the number of matching tweets. Send a JSON number (e.g. 1), not a string (e.g. "1"). Omitted or null uses 1.

next_cursorstring nullable

Cursor from the previous response. Omit or use null for the first request; empty strings are invalid.

Example request

{
  "max_pages": 1
}

Response

Success

codeinteger required
msgstring required
has_next_pageboolean required
next_cursorstring nullable required

Pass unchanged on the next request; null when no continuation is available.

pages_scannedinteger required
tweets_scannedinteger required

Number of tweets scanned, before filtering for paid promotion.

disclosure_unknown_countinteger required

Unique eligible author tweets whose paid-promotion flag is missing; these are excluded from data.

stop_reason'quota_limit' | 'cursor_exhausted' | 'cursor_cycle' | 'page_limit' required

Example response

{
  "data": [
    {
      "tweet_id": "2104354931595423762",
      "is_paid_promotion": true,
      "created_at": "Mon Jun 17 03:51:48 +0000 2024",
      "created_at_datetime": "2024-06-17T03:51:48.000Z",
      "hashtags": [
        "AI",
        "Python"
      ],
      "cashtags": [
        "$TSLA"
      ],
      "lang": "en",
      "media": [
        {
          "id": "1802991873836883968",
          "type": "photo",
          "display_url": "pic.twitter.com/...",
          "height": 1080,
          "width": 1920,
          "aspect_ratio": [
            16,
            9
          ],
          "streams": [
            {
              "url": "https://video.twimg.com/...",
              "bitrate": 832000,
              "content_type": "video/mp4"
            }
          ]
        }
      ],
      "user": {
        "id": "1717001045992251392",
        "name": "Cryptoklepto",
        "screen_name": "CK_Cryptoklepto",
        "created_at": "Mon Oct 28 02:32:47 +0000 2024",
        "created_at_datetime": "2024-10-28T02:32:47.000Z",
        "urls": [
          {
            "url": "https://www.google.com",
            "expanded_url": "https://www.google.com",
            "display_url": "www.google.com"
          }
        ],
        "verified_type": "government",
        "profile_image_shape": "Circle",
        "location": "New York, USA"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.