Ücretli ortaklık gönderilerini ara

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.

API Belgelerine Dön

/Search Endpoints

TwexAPI REST

POST/twitter/search/paid_partnerships

API Yetkilendirmesi

AuthorizationBearer token · headerzorunlu

TwexAPI genel Bearer Token kimlik bilgisi. İstek başlığı: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

İstek Gövdesi

zorunluapplication/json

screen_namestringzorunlu

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

matches ^\s*@?[A-Za-z0-9_]{1,15}\s*$

max_pagesinteger | any

Maximum search pages to scan, not the number of matching tweets. Omitted or null uses 1.

default: 1

Özellikleri göster

Any of:

integer

integer

any

any

next_cursorstring | any

Özellikleri göster

Any of:

string

string

any

any

Yanıtlar

200Success

codeintegerzorunlu

msgstringzorunlu

dataTweetModel[]zorunlu

Özellikleri göster

Array of TweetModel

tweet_idstringzorunlu

Tweetin benzersiz ID'si

is_paid_promotionboolean | any

Indicates whether the content or user is associated with a paid promotion

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

textstringzorunlu

Mesaj metni

created_atstring | any

Oluşturulma zamanı (UTC)

Özellikleri göster

Any of:

string

string

any

any

created_at_datetimestring | any

The ISO 8601 format of the creation date

Özellikleri göster

Any of:

string

string

any

any

bookmark_countinteger | any

Yer işareti sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

bookmarkedboolean | any

Indicates if the authenticating user has bookmarked this Tweet

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

community_notestring | any

Community note associated with the Tweet

Özellikleri göster

Any of:

string

string

any

any

edit_tweet_idsstring[]

A list of Tweet IDs for each edit of the Tweet

default: []

editable_until_msecsstring | any

Timestamp for when the Tweet is no longer editable

Özellikleri göster

Any of:

string

string

any

any

edits_remainingstring | any

Number of edits remaining for the Tweet

Özellikleri göster

Any of:

string

string

any

any

favorite_countinteger | any

Beğeni sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

favoritedboolean | any

Indicates if the authenticating user has liked this Tweet

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

full_textstring | any

Tweetin tam metni

Özellikleri göster

Any of:

string

string

any

any

has_cardboolean | any

Indicates if the Tweet has a card attached

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

has_community_notesboolean | any

Indicates if the Tweet has community notes

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

hashtagsstring[]

A list of hashtags mentioned in the Tweet

default: []

cashtagsstring[]

A list of cashtags (stock symbols) mentioned in the Tweet

default: []

idstring | any

The unique identifier for the Tweet (same as tweet_id)

Özellikleri göster

Any of:

string

string

any

any

in_reply_tostring | any

ID of the Tweet this is a reply to

Özellikleri göster

Any of:

string

string

any

any

in_reply_to_user_idstring | any

ID of the user this is a reply to

Özellikleri göster

Any of:

string

string

any

any

in_reply_to_screen_namestring | any

Screen name of the user this is a reply to

Özellikleri göster

Any of:

string

string

any

any

is_edit_eligibleboolean | any

Indicates if the Tweet is eligible for editing

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

is_quote_statusboolean | any

Indicates if this Tweet is a quote of another Tweet

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

quoted_status_id_strstring | any

The unique identifier for the Tweet that this is a quote of

Özellikleri göster

Any of:

string

string

any

any

is_translatableboolean | any

Indicates if the Tweet is translatable

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

langstring | any

The BCP 47 language identifier for the Tweet's content

Özellikleri göster

Any of:

string

string

any

any

mediaMediaModel[]

A list of media objects (photos, videos) attached to the Tweet

default: []

Özellikleri göster

Array of MediaModel

idstringzorunlu

Media ID

typestringzorunlu

Type of media (e.g., photo, video)

display_urlstring | any

URL of the media to display

Özellikleri göster

Any of:

string

string

any

any

expanded_urlstring | any

Expanded URL for the media

Özellikleri göster

Any of:

string

string

any

any

media_urlstring | any

Direct URL to the media file

Özellikleri göster

Any of:

string

string

any

any

urlstring | any

t.co URL for the media

Özellikleri göster

Any of:

string

string

any

any

heightinteger | any

Height of the media in pixels

Özellikleri göster

Any of:

integer

integer

any

any

widthinteger | any

Width of the media in pixels

Özellikleri göster

Any of:

integer

integer

any

any

featuresobject | any

Features of the media

Özellikleri göster

Any of:

object

object

any

any

original_infoobject | any

Original information about the media

Özellikleri göster

Any of:

object

object

any

any

sizesobject | any

Available sizes of the media

Özellikleri göster

Any of:

object

object

any

any

source_status_idstring | any

Source tweet ID if the media is a retweet

Özellikleri göster

Any of:

string

string

any

any

source_user_idstring | any

Source user ID if the media is a retweet

Özellikleri göster

Any of:

string

string

any

any

duration_millisinteger | any

Duration of the video in milliseconds

Özellikleri göster

Any of:

integer

integer

any

any

aspect_ratiointeger[] | any

Aspect ratio of the video

Özellikleri göster

Any of:

integer[]

Array of integer

integer

any

any

video_infoobject | any

Detailed video information

Özellikleri göster

Any of:

object

object

any

any

streamsStreamModel[]

List of available video streams

default: []

Özellikleri göster

Array of StreamModel

urlstring | any

URL of the video stream

Özellikleri göster

Any of:

string

string

any

any

bitrateinteger | any

Bitrate of the video stream in bps

Özellikleri göster

Any of:

integer

integer

any

any

content_typestring | any

Content type of the stream

Özellikleri göster

Any of:

string

string

any

any

placestring | any

The location associated with the Tweet

Özellikleri göster

Any of:

string

string

any

any

pollstring | any

A poll attached to the Tweet

Özellikleri göster

Any of:

string

string

any

any

possibly_sensitiveboolean | any

Indicates if the Tweet may contain sensitive content

Özellikleri göster

Any of:

boolean

boolean

any

any

possibly_sensitive_editableboolean | any

Indicates if the sensitive content flag is editable

Özellikleri göster

Any of:

boolean

boolean

any

any

quoteTweetModel | any

The Tweet object being quoted

Özellikleri göster

Any of:

TweetModel

Circular reference to TweetModel.

any

any

quote_countinteger | any

Number of times this Tweet has been quoted

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

related_tweetsTweetModel[]

A list of related Tweets

default: []

Özellikleri göster

Array of TweetModel

Circular reference to TweetModel.

repliesTweetModel[]

A list of replies to this Tweet

default: []

Özellikleri göster

Array of TweetModel

Circular reference to TweetModel.

reply_countinteger | any

Yanıt sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

reply_toTweetModel | any

The Tweet object this is a reply to

Özellikleri göster

Any of:

TweetModel

Circular reference to TweetModel.

any

any

retweet_countinteger | any

Retweet sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

retweeted_tweetTweetModel | any

The original Tweet object if this is a retweet

Özellikleri göster

Any of:

TweetModel

Circular reference to TweetModel.

any

any

threadTweetModel[] | any

The conversation thread ID

Özellikleri göster

Any of:

TweetModel[]

Array of TweetModel

Circular reference to TweetModel.

any

any

thumbnail_titlestring | any

Title for the thumbnail in a card

Özellikleri göster

Any of:

string

string

any

any

thumbnail_urlstring | any

URL for the thumbnail in a card

Özellikleri göster

Any of:

string

string

any

any

urlsstring[]

A list of URLs included in the Tweet

default: []

userUserModel | any

The user who posted the Tweet

Özellikleri göster

Any of:

UserModel

idstringzorunlu

User ID

namestringzorunlu

Kullanıcının görünen adı

screen_namestringzorunlu

Twitter kullanıcı adı (@ olmadan)

created_atstring | any

Oluşturulma zamanı (UTC)

Özellikleri göster

Any of:

string

string

any

any

created_at_datetimestring | any

Account creation datetime in ISO format

Özellikleri göster

Any of:

string

string

any

any

can_dmboolean | any

Whether the user can be direct messaged

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

Whether the user can be tagged in media

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

default_profileboolean | any

Whether the user has a default profile

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

Whether the user has a default profile image

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

descriptionstring | any

Profil biyografisi (Bio)

default: ""

Özellikleri göster

Any of:

string

string

any

any

description_urlsstring[]

List of URLs found in the user's description

default: []

urlsurlModel[] | any

List of URLs found in the user's profile

Özellikleri göster

Any of:

urlModel[]

Array of urlModel

urlstringzorunlu

URL

expanded_urlstring | any

Expanded URL

Özellikleri göster

Any of:

string

string

any

any

display_urlstring | any

Display URL

Özellikleri göster

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

Count of fast followers

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

favourites_countinteger | any

Number of tweets the user has liked

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

followers_countinteger | any

Toplam takipçi sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

following_countinteger | any

Toplam takip edilen sayısı

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

has_custom_timelinesboolean | any

Whether the user has custom timelines

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

Blue verification status

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

verified_typestring | any

Verification badge type when not blue-only: blue, business, government, etc.

Özellikleri göster

Any of:

string

string

any

any

is_verifiedboolean | any

True if the account has any verification badge (blue, business, government, or legacy verified)

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

Profile image shape (Circle or Square; Square often indicates business/government)

Özellikleri göster

Any of:

string

string

any

any

is_translatorboolean | any

Whether the user is a translator

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

listed_countinteger | any

Number of public lists the user is a member of

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

locationstring | any

User's location

default: ""

Özellikleri göster

Any of:

string

string

any

any

media_countinteger | any

Number of media tweets posted by the user

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

normal_followers_countinteger | any

Count of normal followers

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

pinned_tweet_idsstring[]

List of pinned tweet IDs

default: []

possibly_sensitiveboolean | any

Whether the user's profile may contain sensitive content

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

URL of the user's profile banner

Özellikleri göster

Any of:

string

string

any

any

profile_image_urlstring | any

URL of the user's profile image

Özellikleri göster

Any of:

string

string

any

any

protectedboolean | any

Whether the user's tweets are protected

default: false

Özellikleri göster

Any of:

boolean

boolean

any

any

statuses_countinteger | any

Number of tweets posted by the user

default: 0

Özellikleri göster

Any of:

integer

integer

any

any

any

any

view_countstring | any

Görüntülenme sayısı

Özellikleri göster

Any of:

string

string

any

any

view_count_statestring | any

State of the view count

Özellikleri göster

Any of:

string

string

any

any

statusobject | any

Raw status dictionary

Özellikleri göster

Any of:

object

object

any

any

target_countinteger | any

The target count of items requested, for context

Özellikleri göster

Any of:

integer

integer

any

any

has_next_pagebooleanzorunlu

next_cursorstring | anyzorunlu

Özellikleri göster

Any of:

string

string

any

any

pages_scannedintegerzorunlu

min 0

tweets_scannedintegerzorunlu

Number of tweets scanned, before filtering for paid promotion.

min 0

disclosure_unknown_countintegerzorunlu

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

min 0

stop_reasonstringzorunlu

İzin verilen:quota_limitcursor_exhaustedcursor_cyclepage_limit

400Invalid request

codeintegerzorunlu

msgstringzorunlu

dataany[] | anyzorunlu

Özellikleri göster

Any of:

any[]

Array of any

any

any

any

403Authentication or credit access denied

codeintegerzorunlu

msgstringzorunlu

dataany[] | anyzorunlu

Özellikleri göster

Any of:

any[]

Array of any

any

any

any

500Upstream or server error

codeintegerzorunlu

msgstringzorunlu

dataany[] | anyzorunlu

Özellikleri göster

Any of:

any[]

Array of any

any

any

any

⚡Etkileşimli Konsol / API TestiPOST/twitter/search/paid_partnerships

Live Console

🌐Hedef Sunucu:https://api.twexapi.io

● Canlı Ortam Hazır

🔍

Genel Veri Okuma (Yalnızca TwexAPI Anahtarı, Twitter Çerezi Gerekmez)

Bu uç nokta herkese açık Twitter verilerini sorgular — Twitter hesabı veya Çerez gerekmez! Test etmek için aşağıdaki "API Yetkilendirmesi"ne TwexAPI Anahtarınızı (Bearer Token) girmeniz yeterlidir.

🔑API Yetkilendirmesi

Anahtarı hatırlaKod örneklerine eşitle

TwexAPI Platform Anahtarı Bearer TokenZorunlu

Tüm TwexAPI uç noktalarında kullanılan genel API anahtarı. Konsoldan alınabilir.

📝İstek Gövdesiapplication/json

screen_namestring

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

max_pagesstring

İsteğe bağlıMaximum search pages to scan, not the number of matching tweets. Omitted or null uses 1.

next_cursorstring

İsteğe bağlı

💡 Hızlı gönder:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

İstek

curl -X POST "https://api.twexapi.io/twitter/search/paid_partnerships" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": null
}'

const response = await fetch("https://api.twexapi.io/twitter/search/paid_partnerships", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": null
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/search/paid_partnerships",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "screen_name": "example_user",
  "max_pages": 1,
  "next_cursor": None
},
)

Yanıt

{
  "code": 200,
  "msg": "success",
  "data": [],
  "has_next_page": false,
  "next_cursor": null,
  "pages_scanned": 1,
  "tweets_scanned": 20,
  "disclosure_unknown_count": 0,
  "stop_reason": "cursor_exhausted"
}

{
  "code": 400,
  "msg": "Invalid request",
  "data": []
}

{
  "code": 403,
  "msg": "Authentication or credit access denied",
  "data": []
}

{
  "code": 500,
  "msg": "Upstream or server error",
  "data": []
}