Buscar tweets dentro de comunidad

Buscar tweets dentro de comunidad.

Volver a la referencia de API

/Communities Endpoints

TwexAPI REST

POST/twitter/community/search-tweets

Autorización de API

AuthorizationBearer token · headerrequerido

Token Bearer global para TwexAPI. Incluido como: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Cuerpo de la solicitud

requeridoapplication/json

community_idstringrequerido

The ID of the community.

target_countintegerrequerido

The number of tweets to search.

querystringrequerido

The query to search for.

Respuestas

200A list of tweet objects.

codeintegerrequerido

Código de estado HTTP (200 indica éxito)

msgstringrequerido

Mensaje de respuesta (ej. 'success')

dataTweetModel[]requerido

Carga de datos devuelta por el endpoint

Mostrar propiedades

Array of TweetModel

tweet_idstringrequerido

ID numérico único del tweet

is_paid_promotionboolean | any

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

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

textstringrequerido

Texto del mensaje

created_atstring | any

Fecha y hora de creación (UTC)

Mostrar propiedades

Any of:

string

string

any

any

created_at_datetimestring | any

The ISO 8601 format of the creation date

Mostrar propiedades

Any of:

string

string

any

any

bookmark_countinteger | any

Número de marcadores

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

bookmarkedboolean | any

Indicates if the authenticating user has bookmarked this Tweet

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

community_notestring | any

Community note associated with the Tweet

Mostrar propiedades

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

Mostrar propiedades

Any of:

string

string

any

any

edits_remainingstring | any

Number of edits remaining for the Tweet

Mostrar propiedades

Any of:

string

string

any

any

favorite_countinteger | any

Número de me gusta

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

favoritedboolean | any

Indicates if the authenticating user has liked this Tweet

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

full_textstring | any

Texto completo del tweet

Mostrar propiedades

Any of:

string

string

any

any

has_cardboolean | any

Indicates if the Tweet has a card attached

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

has_community_notesboolean | any

Indicates if the Tweet has community notes

default: false

Mostrar propiedades

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)

Mostrar propiedades

Any of:

string

string

any

any

in_reply_tostring | any

ID of the Tweet this is a reply to

Mostrar propiedades

Any of:

string

string

any

any

in_reply_to_user_idstring | any

ID of the user this is a reply to

Mostrar propiedades

Any of:

string

string

any

any

in_reply_to_screen_namestring | any

Screen name of the user this is a reply to

Mostrar propiedades

Any of:

string

string

any

any

is_edit_eligibleboolean | any

Indicates if the Tweet is eligible for editing

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

is_quote_statusboolean | any

Indicates if this Tweet is a quote of another Tweet

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

quoted_status_id_strstring | any

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

Mostrar propiedades

Any of:

string

string

any

any

is_translatableboolean | any

Indicates if the Tweet is translatable

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

langstring | any

The BCP 47 language identifier for the Tweet's content

Mostrar propiedades

Any of:

string

string

any

any

mediaMediaModel[]

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

default: []

Mostrar propiedades

Array of MediaModel

idstringrequerido

Media ID

typestringrequerido

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

display_urlstring | any

URL of the media to display

Mostrar propiedades

Any of:

string

string

any

any

expanded_urlstring | any

Expanded URL for the media

Mostrar propiedades

Any of:

string

string

any

any

media_urlstring | any

Direct URL to the media file

Mostrar propiedades

Any of:

string

string

any

any

urlstring | any

t.co URL for the media

Mostrar propiedades

Any of:

string

string

any

any

heightinteger | any

Height of the media in pixels

Mostrar propiedades

Any of:

integer

integer

any

any

widthinteger | any

Width of the media in pixels

Mostrar propiedades

Any of:

integer

integer

any

any

featuresobject | any

Features of the media

Mostrar propiedades

Any of:

object

object

any

any

original_infoobject | any

Original information about the media

Mostrar propiedades

Any of:

object

object

any

any

sizesobject | any

Available sizes of the media

Mostrar propiedades

Any of:

object

object

any

any

source_status_idstring | any

Source tweet ID if the media is a retweet

Mostrar propiedades

Any of:

string

string

any

any

source_user_idstring | any

Source user ID if the media is a retweet

Mostrar propiedades

Any of:

string

string

any

any

duration_millisinteger | any

Duration of the video in milliseconds

Mostrar propiedades

Any of:

integer

integer

any

any

aspect_ratiointeger[] | any

Aspect ratio of the video

Mostrar propiedades

Any of:

integer[]

Array of integer

integer

any

any

video_infoobject | any

Detailed video information

Mostrar propiedades

Any of:

object

object

any

any

streamsStreamModel[]

List of available video streams

default: []

Mostrar propiedades

Array of StreamModel

urlstring | any

URL of the video stream

Mostrar propiedades

Any of:

string

string

any

any

bitrateinteger | any

Bitrate of the video stream in bps

Mostrar propiedades

Any of:

integer

integer

any

any

content_typestring | any

Content type of the stream

Mostrar propiedades

Any of:

string

string

any

any

placestring | any

The location associated with the Tweet

Mostrar propiedades

Any of:

string

string

any

any

pollstring | any

A poll attached to the Tweet

Mostrar propiedades

Any of:

string

string

any

any

possibly_sensitiveboolean | any

Indicates if the Tweet may contain sensitive content

Mostrar propiedades

Any of:

boolean

boolean

any

any

possibly_sensitive_editableboolean | any

Indicates if the sensitive content flag is editable

Mostrar propiedades

Any of:

boolean

boolean

any

any

quoteTweetModel | any

The Tweet object being quoted

Mostrar propiedades

Any of:

TweetModel

Circular reference to TweetModel.

any

any

quote_countinteger | any

Number of times this Tweet has been quoted

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

related_tweetsTweetModel[]

A list of related Tweets

default: []

Mostrar propiedades

Array of TweetModel

Circular reference to TweetModel.

repliesTweetModel[]

A list of replies to this Tweet

default: []

Mostrar propiedades

Array of TweetModel

Circular reference to TweetModel.

reply_countinteger | any

Número de respuestas

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

reply_toTweetModel | any

The Tweet object this is a reply to

Mostrar propiedades

Any of:

TweetModel

Circular reference to TweetModel.

any

any

retweet_countinteger | any

Número de retweets

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

retweeted_tweetTweetModel | any

The original Tweet object if this is a retweet

Mostrar propiedades

Any of:

TweetModel

Circular reference to TweetModel.

any

any

threadTweetModel[] | any

The conversation thread ID

Mostrar propiedades

Any of:

TweetModel[]

Array of TweetModel

Circular reference to TweetModel.

any

any

thumbnail_titlestring | any

Title for the thumbnail in a card

Mostrar propiedades

Any of:

string

string

any

any

thumbnail_urlstring | any

URL for the thumbnail in a card

Mostrar propiedades

Any of:

string

string

any

any

urlsstring[]

A list of URLs included in the Tweet

default: []

userUserModel | any

The user who posted the Tweet

Mostrar propiedades

Any of:

UserModel

idstringrequerido

User ID

namestringrequerido

Nombre mostrado del usuario

screen_namestringrequerido

Nombre de usuario (Handle, sin @)

created_atstring | any

Fecha y hora de creación (UTC)

Mostrar propiedades

Any of:

string

string

any

any

created_at_datetimestring | any

Account creation datetime in ISO format

Mostrar propiedades

Any of:

string

string

any

any

can_dmboolean | any

Whether the user can be direct messaged

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

can_media_tagboolean | any

Whether the user can be tagged in media

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

default_profileboolean | any

Whether the user has a default profile

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

default_profile_imageboolean | any

Whether the user has a default profile image

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

descriptionstring | any

Biografía del perfil

default: ""

Mostrar propiedades

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

Mostrar propiedades

Any of:

urlModel[]

Array of urlModel

urlstringrequerido

URL

expanded_urlstring | any

Expanded URL

Mostrar propiedades

Any of:

string

string

any

any

display_urlstring | any

Display URL

Mostrar propiedades

Any of:

string

string

any

any

any

any

fast_followers_countinteger | any

Count of fast followers

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

favourites_countinteger | any

Number of tweets the user has liked

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

followers_countinteger | any

Número total de seguidores

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

following_countinteger | any

Número total de seguidos

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

has_custom_timelinesboolean | any

Whether the user has custom timelines

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

is_blue_verifiedboolean | any

Blue verification status

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

verified_typestring | any

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

Mostrar propiedades

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

Mostrar propiedades

Any of:

boolean

boolean

any

any

profile_image_shapestring | any

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

Mostrar propiedades

Any of:

string

string

any

any

is_translatorboolean | any

Whether the user is a translator

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

listed_countinteger | any

Number of public lists the user is a member of

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

locationstring | any

User's location

default: ""

Mostrar propiedades

Any of:

string

string

any

any

media_countinteger | any

Number of media tweets posted by the user

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

normal_followers_countinteger | any

Count of normal followers

default: 0

Mostrar propiedades

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

Mostrar propiedades

Any of:

boolean

boolean

any

any

profile_banner_urlstring | any

URL of the user's profile banner

Mostrar propiedades

Any of:

string

string

any

any

profile_image_urlstring | any

URL of the user's profile image

Mostrar propiedades

Any of:

string

string

any

any

protectedboolean | any

Whether the user's tweets are protected

default: false

Mostrar propiedades

Any of:

boolean

boolean

any

any

statuses_countinteger | any

Number of tweets posted by the user

default: 0

Mostrar propiedades

Any of:

integer

integer

any

any

any

any

view_countstring | any

Número de visualizaciones

Mostrar propiedades

Any of:

string

string

any

any

view_count_statestring | any

State of the view count

Mostrar propiedades

Any of:

string

string

any

any

statusobject | any

Raw status dictionary

Mostrar propiedades

Any of:

object

object

any

any

target_countinteger | any

The target count of items requested, for context

Mostrar propiedades

Any of:

integer

integer

any

any

422Error de validación de parámetros

detailValidationError[]

Mostrar propiedades

Array of ValidationError

locstring | integer[]requerido

Mostrar propiedades

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequerido

Mensaje de respuesta (ej. 'success')

typestringrequerido

inputany

ctxobject

⚡Consola interactiva / Probar APIPOST/twitter/community/search-tweets

Live Console

🌐Servidor objetivo:https://api.twexapi.io

● Producción lista

🔍

Lectura de datos públicos (Solo clave TwexAPI, sin cookie de Twitter)

Este endpoint consulta datos públicos de Twitter: ¡no se requiere cuenta ni Cookie de Twitter! Simplemente ingrese su clave TwexAPI (Bearer Token) en "Autorización API" para probar.

🔑Autorización API

Recordar claveSincronizar con código

Clave de plataforma TwexAPI Bearer TokenObligatorio

Clave API global utilizada en todos los endpoints de TwexAPI. Disponible en la consola.

📝Cuerpo de la solicitudapplication/json

community_idstring

ObligatorioThe ID of the community.

target_countinteger

ObligatorioThe number of tweets to search.

querystring

ObligatorioThe query to search for.

💡 Envío rápido:⌘ / Ctrl+Enter

📡

暂无响应数据

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

Solicitud

curl -X POST "https://api.twexapi.io/twitter/community/search-tweets" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "community_id": "string",
  "target_count": 0,
  "query": "string"
}'

const response = await fetch("https://api.twexapi.io/twitter/community/search-tweets", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "community_id": "string",
  "target_count": 0,
  "query": "string"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/twitter/community/search-tweets",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "community_id": "string",
  "target_count": 0,
  "query": "string"
},
)

Respuesta

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "tweet_id": "1803006263529541838",
      "is_paid_promotion": true,
      "text": "string",
      "created_at": "Mon Jun 17 03:51:48 +0000 2024",
      "created_at_datetime": "2024-06-17T03:51:48.000Z",
      "bookmark_count": 0,
      "bookmarked": false,
      "community_note": "string",
      "edit_tweet_ids": [],
      "editable_until_msecs": "string",
      "edits_remaining": "string",
      "favorite_count": 0,
      "favorited": false,
      "full_text": "string",
      "has_card": false,
      "has_community_notes": false,
      "hashtags": [
        "AI",
        "Python"
      ],
      "cashtags": [
        "$TSLA"
      ],
      "id": "string",
      "in_reply_to": "string",
      "in_reply_to_user_id": "string",
      "in_reply_to_screen_name": "string",
      "is_edit_eligible": false,
      "is_quote_status": false,
      "quoted_status_id_str": "string",
      "is_translatable": false,
      "lang": "en",
      "media": [],
      "place": "string",
      "poll": "string",
      "possibly_sensitive": true,
      "possibly_sensitive_editable": true,
      "quote": {},
      "quote_count": 0,
      "related_tweets": [],
      "replies": [],
      "reply_count": 0,
      "reply_to": {},
      "retweet_count": 0,
      "retweeted_tweet": {},
      "thread": [
        {}
      ],
      "thumbnail_title": "string",
      "thumbnail_url": "string",
      "urls": [],
      "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",
        "can_dm": false,
        "can_media_tag": false,
        "default_profile": false,
        "default_profile_image": false,
        "description": "",
        "description_urls": [],
        "urls": [
          {
            "url": "https://www.google.com",
            "expanded_url": "https://www.google.com",
            "display_url": "www.google.com"
          }
        ],
        "fast_followers_count": 0,
        "favourites_count": 0,
        "followers_count": 0,
        "following_count": 0,
        "has_custom_timelines": false,
        "is_blue_verified": false,
        "verified_type": "government",
        "is_verified": false,
        "profile_image_shape": "Circle",
        "is_translator": false,
        "listed_count": 0,
        "location": "New York, USA",
        "media_count": 0,
        "normal_followers_count": 0,
        "pinned_tweet_ids": [],
        "possibly_sensitive": false,
        "profile_banner_url": "string",
        "profile_image_url": "string",
        "protected": false,
        "statuses_count": 0
      },
      "view_count": "string",
      "view_count_state": "string",
      "status": {},
      "target_count": 0
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}