Modelo de objetos
Tweet
id, text y created_at. Los objetos Tweet también son el objeto “principal” de varios objetos secundarios, incluidos user, media, poll y place. Usa el parámetro de campo tweet.fields al solicitar estos campos de nivel raíz en el objeto Tweet.
El objeto Tweet se puede encontrar y expandir en el recurso de usuario. También se pueden encontrar y expandir Tweets adicionales relacionados con el Tweet solicitado en el recurso Tweet. El objeto está disponible para expansión con ?expansions=pinned_tweet_id en el recurso de usuario o ?expansions=referenced_tweets.id en el recurso Tweet para obtener el objeto solo con los campos predeterminados. Usa la expansión junto con el parámetro de campo tweet.fields al solicitar campos adicionales para completar el objeto.
| Valor del Campo | Tipo | Descripción | Cómo Se Puede Usar |
|---|---|---|---|
| id (predeterminado) | string | El identificador único del Tweet solicitado. | Utilícelo para recuperar programáticamente un Tweet específico. |
| text (predeterminado) | string | El texto UTF-8 real del Tweet. Consulte twitter-text para obtener detalles sobre caracteres válidos. | Extracción de palabras clave y análisis/clasificación de sentimientos. |
| edit_history_tweet_ids (predeterminado) | object | Identificadores únicos que indican todas las versiones de un Tweet. Para Tweets sin ediciones, habrá un ID. Para Tweets con historial de edición, habrá múltiples IDs. | Utilice esta información para encontrar el historial de edición de un Tweet. |
| article | object | Contiene metadatos para el Artículo presente en este Tweet. | Utilícelo para obtener el texto y las entidades de un Artículo. |
| attachments | object | Especifica el tipo de archivos adjuntos (si los hay) presentes en este Tweet. | Comprender los objetos devueltos para las expansiones solicitadas. |
| author_id | string | El identificador único del Usuario que publicó este Tweet. | Hidratar objeto de Usuario, compartir conjunto de datos para revisión por pares. |
| card_uri | string | El URI para la Tarjeta presente en este tweet. | |
| community_id | string | El identificador único para la Comunidad a la que pertenece este Post. | |
| context_annotations | array | Contiene anotaciones de contexto para el Tweet. | Reconocimiento/extracción de entidades, análisis temático. |
| conversation_id | string | El ID del Tweet original de la conversación (que incluye respuestas directas, respuestas de respuestas). | Utilícelo para reconstruir la conversación a partir de un Tweet. |
| created_at | date (ISO 8601) | Hora de creación del Tweet. | Útil para análisis de series temporales y comprender cuándo se creó un Tweet. |
| display_text_range | array | Un array que contiene un índice de inicio y fin para la porción de texto que se muestra. | Útil para saber qué porción de texto se muestra por defecto para Posts largos. |
| edit_controls | object | Indica cuánto tiempo más se puede editar el Tweet y el número de ediciones restantes. | Utilícelo para determinar si un Tweet es elegible para edición. |
| entities | object | Entidades que han sido analizadas del texto del Tweet. Consulte entidades en Objetos de Twitter. | Proporciona información adicional sobre hashtags, URLs, menciones, etc. |
| geo | object | Indica la ubicación o lugar de un Tweet geoetiquetado. | Utilícelo para determinar la ubicación de un Tweet geoetiquetado. |
| in_reply_to_user_id | string | Si el Tweet representado es una respuesta, este campo contendrá el ID del autor del Tweet original. | Determinar si un Tweet fue en respuesta a otro Tweet. |
| lang | string | Idioma del Tweet, si es detectado por Twitter. | Clasificar Tweets por idioma hablado. |
| non_public_metrics | object | Métricas de participación no públicas para el Tweet al momento de la solicitud. Requiere autenticación de contexto de usuario. | Determinar las impresiones totales generadas para el Tweet. |
| note_tweet | object | Contiene el texto completo de un Post para Posts de formato largo (>280 caracteres). | Obtener el texto completo de un Post. |
| organic_metrics | object | Métricas de participación, rastreadas en un contexto orgánico, para el Tweet al momento de la solicitud. Requiere autenticación de contexto de usuario. | Medir la participación orgánica para el Tweet. |
| possibly_sensitive | boolean | Indica si el contenido puede ser reconocido como sensible. | Estudiar la circulación de ciertos tipos de contenido. |
| promoted_metrics | object | Métricas de participación, rastreadas en un contexto promocionado, para el Tweet al momento de la solicitud. Requiere autenticación de contexto de usuario. | Medir la participación para el Tweet cuando fue promocionado. |
| public_metrics | object | Métricas de participación públicas para el Tweet al momento de la solicitud. | Medir la participación del Tweet. |
| referenced_tweets | array | Una lista de Tweets a los que este Tweet se refiere, como Retweets, Tweets citados o respuestas. | Comprender aspectos conversacionales de retweets, etc. |
| reply_settings | string | Muestra quién puede responder a un Tweet dado. Las opciones son “everyone”, “mentioned_users” y “followers”. | Determinar la configuración de respuesta de conversación para el Tweet. |
| withheld | object | Contiene detalles de retención para contenido retenido. | |
| scopes | object | Contiene detalles de alcance para el tweet. | Indica quién puede ver el Post. Solo se devuelve para Posts promocionados. |
| media_metadata | array | Contiene metadatos para archivos adjuntos de medios del Tweet. | Obtener metadatos adicionales como el alt_text de un archivo adjunto de medios de un Tweet. |
$BEARER_TOKEN por tu propio Bearer Token generado.
Usuario
user.fields.
El objeto de usuario también puede aparecer como objeto hijo y expandirse dentro del objeto Tweet. Está disponible para expansión con ?expansions=author_id o ?expansions=in_reply_to_user_id para obtener el objeto condensado con solo los campos predeterminados. Use la expansión junto con el parámetro user.fields al solicitar campos adicionales para completar el objeto.
| Valor del campo | Tipo | Descripción | Cómo se puede usar |
|---|---|---|---|
| id (predeterminado) | string | El identificador único de este usuario."id": "2244994945" | Utilízalo para recuperar información de forma programática sobre un usuario específico de Twitter. |
| name (predeterminado) | string | El nombre del usuario, tal como lo ha definido en su perfil. No necesariamente es el nombre de una persona. Generalmente limitado a 50 caracteres, pero sujeto a cambios."name": "Twitter Dev" | |
| username (predeterminado) | string | El nombre de usuario, identificador o alias de Twitter con el que este usuario se identifica. Los nombres de usuario son únicos pero sujetos a cambios. Generalmente tienen un máximo de 15 caracteres de longitud, pero algunas cuentas históricas pueden tener nombres más largos."username": "TwitterDev" | |
| affiliation | object | Contiene detalles sobre la afiliación de un usuario. | Se puede usar para obtener la insignia de afiliado de un usuario. |
| confirmed_email | string | El correo electrónico confirmado del usuario autenticado. | |
| connection_status | array | Proporciona una lista de relaciones entre el usuario autenticado y el usuario que se está consultando, como siguiendo, seguido, solicitud de seguimiento enviada, solicitud de seguimiento recibida, bloqueando, silenciando ”connection_status”: [ “follow_request_received”, “follow_request_sent”, “blocking”, “followed_by”, “following”, “muting” ] | Se puede usar para determinar el estado de conexión entre el usuario autenticado y el usuario que se está consultando. |
| created_at | date (ISO 8601) | La fecha y hora UTC en que se creó la cuenta de usuario en Twitter."created_at": "2013-12-14T04:35:55.000Z" | Se puede usar para determinar cuánto tiempo lleva alguien usando Twitter |
| description | string | El texto de la descripción del perfil de este usuario (también conocida como biografía), si el usuario proporcionó una."description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API." | |
| entities | object | Contiene detalles sobre texto que tiene un significado especial en la descripción del usuario."entities": { <br/> "url": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> } <br/> ] <br/> }, <br/> "description": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> }, <br/> "hashtags": [ <br/> { <br/> "start": 23, <br/> "end": 30, <br/> "tag": "DevRel" <br/> }, <br/> { <br/> "start": 113, <br/> "end": 130, <br/> "tag": "BlackLivesMatter" <br/> }, <br/> "mentions": [ <br/> { <br/> "start": 0, <br/> "end": 10, <br/> "tag": "TwitterDev" <br/> }, <br/> "cashtags": [ <br/> { <br/> "start": 12, <br/> "end": 16, <br/> "tag": "twtr" <br/> } <br/> ] <br/> } <br/> } | Las entidades son objetos JSON que proporcionan información adicional sobre hashtags, URLs, menciones de usuarios y cashtags asociados con la descripción. Consulta cada entidad respectiva para obtener más detalles. Todos los índices start de usuario son inclusivos, mientras que todos los índices end de usuario son exclusivos. |
| is_identity_verified | boolean | Indica si el usuario tiene verificación de identidad. | |
| location | string | La ubicación especificada en el perfil del usuario, si el usuario proporcionó una. Como este es un valor de forma libre, puede no indicar una ubicación válida, pero puede ser evaluada de manera aproximada al realizar búsquedas con consultas de ubicación."location": "127.0.0.1" | |
| most_recent_tweet_id | string | Identificador único del Tweet más reciente de este usuario. | Permite determinar el Tweet más reciente del usuario. |
| parody | boolean | Indica si esta cuenta de usuario tiene o no la etiqueta de Parodia. | |
| pinned_tweet_id | string | Identificador único del Tweet fijado de este usuario."pinned_tweet_id": "1255542774432063488" | Permite determinar el Tweet fijado en la parte superior del perfil del usuario. Potencialmente se puede usar para determinar el idioma del usuario. |
| profile_banner_url | string | La URL del banner del perfil para este usuario, como se muestra en el perfil del usuario."profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1721022977" | Se puede usar para descargar el banner del perfil de este usuario. |
| profile_image_url | string | La URL de la imagen del perfil para este usuario, como se muestra en el perfil del usuario."profile_image_url": "https://pbs.twimg.com/profile_images/1267175364003901441/tBZNFAgA_normal.jpg" | Se puede usar para descargar la imagen del perfil de este usuario. |
| protected | boolean | Indica si este usuario ha elegido proteger sus Tweets (en otras palabras, si los Tweets de este usuario son privados)."protected": false | |
| public_metrics | object | Contiene detalles sobre la actividad de este usuario."public_metrics": { "followers_count": 507902, "following_count": 1863, "tweet_count": 3561, "listed_count": 1550 } | Se puede utilizar para determinar el alcance o influencia de un usuario de X, cuantificar el rango de intereses del usuario y su nivel de participación en X. |
| receives_your_dm | boolean | Indica si este usuario recibirá o no el mensaje directo del usuario autenticado. | |
| subscription | object | Contiene detalles sobre si el usuario está suscrito o no al usuario autenticado. | |
| subscription_type | string | Una cadena que representa el tipo de suscripción X Premium que tiene el usuario autenticado. Ejemplo: None, Basic, Premium, PremiumPlus. Siempre devolverá None si el usuario no es el usuario autenticado. | |
| url | string | La URL especificada en el perfil del usuario, si está presente."url": "https://t.co/3ZX3TNiZCY" | Una URL proporcionada por un usuario de X en su perfil. Puede ser una página principal, pero no siempre es el caso. |
| verified | boolean | Indica si este usuario es un usuario verificado de X."verified": true | Indica si este usuario de X tiene o no una cuenta verificada. Una cuenta verificada permite a las personas saber que una cuenta de interés público es auténtica. |
| verified_followers_count | string | Una cadena que representa el número de seguidores verificados de un usuario. | |
| verified_type | string | Una cadena que representa el tipo de verificación que tiene un usuario. Ejemplo: “blue”, “business”, “government” | |
| withheld | object | Contiene detalles de retención para contenido retenido, si corresponde. |
$BEARER_TOKEN por tu propio Bearer Token generado.
Space
host_ids, creator_id, speaker_ids, mentioned_user_ids al parámetro expansions de la query.
A diferencia de los Tweets, los Spaces son efímeros y dejan de estar disponibles cuando terminan o cuando su creador los cancela. Cuando tu App maneja datos de Spaces, eres responsable de devolver la información más actualizada y debes eliminar los datos que ya no estén disponibles en la plataforma. Los endpoints de consulta de Spaces pueden ayudarte a garantizar que respetas las expectativas e intención de los usuarios.
| Valor del campo | Type | Descripción | Cómo se puede usar |
|---|---|---|---|
| id (default) | string | Identificador único del Space solicitado."id": "1zqKVXPQhvZJB" | Identificar de forma única un Space devuelto en la respuesta. |
| state (default) | string | Indica si el Space ha comenzado, comenzará o ha finalizado."state": "live" | Filtrar Spaces en vivo o programados. |
| created_at | date (ISO 8601) | Hora de creación de este Space."created_at": "2021-07-04T23:12:08.000Z" | Determinar cuándo se creó un Space y ordenar por tiempo. |
| creator_id | string | Identificador único del creador del Space."creator_id": "2244994945" | |
| ended_at | date (ISO 8601) | Hora en que finalizó el Space, si corresponde."ended_at": "2021-07-04T00:11:44.000Z" | Determinar cuándo terminó un Space en vivo para calcular su duración. |
| host_ids | array | Identificadores únicos de los anfitriones del Space."host_ids": ["2244994945", "6253282"] | Expandir objetos de usuario, comprender la interacción. |
| lang | string | Idioma del Space, si se detecta."lang": "en" | Clasificar Spaces por idioma. |
| is_ticketed | boolean | Indica si es un Space con entradas."is_ticketed": false | Destacar contenido de interés. |
| invited_user_ids | array | Lista de IDs de usuarios invitados como oradores."invited_user_ids": ["2244994945", "6253282"] | Expandir objetos de usuario, comprender la interacción. |
| participant_count | integer | Número de usuarios en el Space, incluidos anfitriones y oradores."participant_count": 420 | Entender la interacción, crear informes. |
| subscriber_count | integer | Número de personas que establecieron un recordatorio para un Space."subscriber_count": 36 | Entender el interés en el evento. |
| scheduled_start | date (ISO 8601) | Hora de inicio programada del Space."scheduled_start": "2021-07-14T08:00:00.000Z" | Integrar con notificaciones de calendario. |
| speaker_ids | array | Lista de usuarios que hablaron en algún momento."speaker_ids": ["2244994945", "6253282"] | Expandir objetos de usuario, comprender la interacción. |
| started_at | date (ISO 8601) | Hora de inicio real de un Space."started_at": "2021-07-14T08:00:12.000Z" | Determinar la hora de inicio del Space. |
| title | string | Título del Space."title": "Say hello to the Space data object!" | Entender palabras clave, hashtags, menciones. |
| topic_ids | array | IDs de los temas seleccionados por el creador del Space."topic_ids": ["2244994945", "6253282"] | Entender palabras clave, hashtags, menciones. |
| updated_at | date (ISO 8601) | Última actualización de los metadatos del Space."updated_at": "2021-07-11T14:44:44.000Z" | Mantener la información actualizada. |
$BEARER_TOKEN por tu propio Bearer Token generado.
List
list.fields.
El objeto List no aparece como hijo de otros objetos de data. Sin embargo, los objetos de usuario pueden encontrarse y expandirse en el recurso de usuario. Estos objetos están disponibles para expansión agregando owner_id al parámetro de query expansions. Use esta expansión con el parámetro de campos list.fields cuando solicite campos adicionales para completar el objeto principal de List y user.fields para completar el objeto de expansión.
| Field Value | Type | Description | How it can be used |
|---|---|---|---|
| id (default) | string | El identificador único de esta List."id": "2244994945" | Úselo para recuperar de forma programática información sobre una List específica. |
| name (default) | string | El nombre de la List, tal como se definió al crearla."name": "Twitter Lists" | |
| created_at | date (ISO 8601) | La fecha y hora en UTC cuando se creó la List."created_at": "2013-12-14T04:35:55.000Z" | Determine cuánto tiempo ha estado una List en X. |
| description | string | Una breve descripción para informar a los usuarios sobre la List."description": "People that are active members of the Bay area cycling community on X." | |
| follower_count | integer | Muestra cuántos usuarios siguen esta List."follower_count": 198 | |
| member_count | integer | Muestra cuántos miembros forman parte de esta List."member_count": 60 | |
| private | boolean | Indica si la List es privada."private": false | |
| owner_id | string | Identificador único del propietario de esta List."owner_id": "1255542774432063488" | Puede usarse para averiguar si este usuario posee otras Lists y expandir objetos de usuario. |
$BEARER_TOKEN con su Bearer Token generado.
Media
?expansions=attachments.media_keys para obtener el objeto condensado con solo los campos predeterminados. Use la expansión junto con el parámetro de fields: media.fields cuando solicite campos adicionales para completar el objeto.
| Field value | Type | Description | How it can be used |
|---|---|---|---|
| media_key (default) | string | Identificador único del contenido de media expandido. "media_key": "13_1263145212760805376" | Puede usarse para recuperar contenido de media de forma programática |
| type (default) | string | Tipo de contenido (animated_gif, photo, video). "type": "video" | Clasificar el contenido como foto, GIF o video |
| url | string | URL directa al archivo de media en Twitter. | Devuelve un objeto Media con un campo URL para fotos |
| duration_ms | integer | Disponible cuando el tipo es video. Duración del video en milisegundos. "duration_ms": 46947 | |
| height | integer | Altura de este contenido en píxeles. "height": 1080 | |
| non_public_metrics | object | metrics de interacción no públicas del contenido de media en el momento de la solicitud. Requiere autenticación con contexto de usuario. "non_public_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183,} | Determinar la interacción con el video: cuántos usuarios reprodujeron hasta cada cuarto del video. |
| organic_metrics | object | metrics de interacción del contenido de media, registradas en un contexto orgánico, en el momento de la solicitud. Requiere autenticación con contexto de usuario. "organic_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183, "view_count": 629} | Determinar la interacción orgánica con el contenido de media. |
| preview_image_url | string | URL de la vista previa estática de este contenido. "preview_image_url": "https://pbs.twimg.com/media/EYeX7akWsAIP1_1.jpg" | |
| promoted_metrics | object | metrics de interacción del contenido de media, registradas en un contexto promocionado, en el momento de la solicitud. Requiere autenticación con contexto de usuario. "promoted_metrics": { "playback_0_count": 259, "playback_100_count": 15, "playback_25_count": 113, "playback_50_count": 57, "playback_75_count": 25, "view_count": 124} | Determinar la interacción con el contenido cuando el Tweet fue promocionado. |
| public_metrics | object | metrics de interacción públicas del contenido de media en el momento de la solicitud. "public_metrics": { "view_count": 6865141} | Determinar el número total de visualizaciones del video adjunto al Tweet. |
| width | integer | Ancho de este contenido en píxeles. "width": 1920 | |
| alt_text | string | Descripción de una imagen para habilitar y respaldar la accesibilidad. Puede tener hasta 1000 caracteres. Actualmente, el texto alternativo solo puede agregarse a imágenes. "alt_text": "Rugged hills along the Na Pali coast on the island of Kauai" | Puede usarse para proporcionar una descripción escrita de una imagen en caso de que un usuario tenga discapacidad visual. |
| variants | array | Cada objeto de media puede tener múltiples variantes de visualización o reproducción, con diferentes resoluciones o formatos. "variants": [{ "bit_rate": 632000, "content_type": "video/mp4", "url": "https://video.twimg.com/ext_tw_video/1527322141724532740/pu/vid/320x568/lnBaR2hCqE-R_90a.mp4?tag=12"}] |
attachment.media_keys. Asegúrate de reemplazar $BEARER_TOKEN por tu propio Bearer Token generado.
Encuesta
?expansions=attachments.poll_ids para obtener la versión condensada con solo los campos predeterminados. Use la expansión junto con el parámetro de campos poll.fields al solicitar campos adicionales para completar el objeto.
| Field value | Type | Description |
|---|---|---|
| id (default) | string | Identificador único de la encuesta expandida. |
{"id": "1199786642791452673"} | ||
| options (default) | array | Contiene objetos que describen cada opción de la encuesta referenciada. |
{"options": [ { "position": 1, "label": "“C Sharp”", "votes": 795 }, { "position": 2, "label": "“C Hashtag”", "votes": 156 } ]} | ||
| duration_minutes | integer | Especifica la duración total de esta encuesta. |
{"duration_minutes": 1440} | ||
| end_datetime | date (ISO 8601) | Especifica la fecha y la hora de finalización de esta encuesta. |
{"end_datetime": "2019-11-28T20:26:41.000Z"} | ||
| voting_status | string | Indica si esta encuesta sigue activa y puede recibir votos o si la votación ya está cerrada. |
{"voting_status": "closed"} |
attachments.poll_id. Asegúrese de reemplazar $BEARER_TOKEN por su propio Bearer Token generado.
Place
?expansions=geo.place_id para obtener el objeto condensado con solo los campos predeterminados. Usa la expansión junto con el parámetro de campos place.fields cuando solicites campos adicionales para completar el objeto.
| Field value | Type | Description | How it can be used |
|---|---|---|---|
| full_name (default) | string | Un nombre de lugar detallado de forma más extensa. | Clasificar un Tweet por un nombre de lugar específico |
"full_name": "Manhattan, NY" | |||
| id (default) | string | El identificador único del lugar expandido, si se trata de un punto de interés etiquetado en el Tweet. | Usa esto para recuperar un lugar de forma programática |
"id": "01a9a39529b27f36" | |||
| contained_within | array | Devuelve los identificadores de lugares conocidos que contienen el lugar de referencia. | |
| country | string | El nombre completo del país al que pertenece este lugar. | Clasificar un Tweet por nombre de país |
"country": "United States" | |||
| country_code | string | El código de país ISO Alpha-2 al que pertenece este lugar. | Clasificar un Tweet por código de país |
"country_code": "US" | |||
| geo | object | Contiene detalles del lugar en formato GeoJSON. | |
| `json | |||
| ”geo”: | |||
| “type”: “Feature”, | |||
| “bbox”: [ | |||
| -74.026675, | |||
| 40.683935, | |||
| -73.910408, | |||
| 40.877483 | |||
| ], | |||
| “properties”: | |||
| } | |||
| ` | |||
| name | string | El nombre corto de este lugar. | Clasificar un Tweet por un nombre de lugar específico |
"name": "Manhattan" | |||
| place_type | string | Especifica el tipo particular de información representada por este lugar, como el nombre de una ciudad o un punto de interés. | Clasificar un Tweet por un tipo específico de lugar |
"place_type": "city" |
geo.place_id. Asegúrate de reemplazar $BEARER_TOKEN con tu propio Bearer Token generado.
Eventos de Mensajes Directos
- sender_id - El id de la cuenta que envió el mensaje o que invitó a un participante a una conversación grupal
- participant_ids - Una matriz de id de cuenta. En los eventos ParticipantsJoin y ParticipantsLeave, esta matriz contendrá un único id de la cuenta que creó el evento
- attachments - Proporciona id de medios para contenido que el remitente ha subido a X
- referenced_tweets - Si se encuentra una URL de un Tweet en el campo text, el id de ese Tweet se incluye en la respuesta
| Valor del campo | Tipo | Descripción | Cómo se puede usar |
| id (default) | string | El identificador único del evento. ”id”: “1050118621198921728” | Úsalo para recuperar de forma programática un evento de conversación específico (disponible con endpoints v1.1). |
| event_type (default) | string | Describe el tipo de evento. Actualmente se admiten tres tipos: * MessageCreate * ParticipantsJoin * ParticipantsLeave “event_type”: “MessageCreate” | Al recuperar el historial de una conversación, entender cuándo se crearon los mensajes y, en conversaciones grupales, cuándo los participantes se unieron y cuándo se fueron. Todos los métodos GET admiten el filtrado por tipos de evento específicos con el parámetro de consulta event_type=. |
| text (default) | string | El texto UTF-8 del Mensaje Directo. “text”: “Hello, just you!” | Con chatbots, se puede usar para analizar el contenido del mensaje y determinar respuestas automatizadas. También puede usarse para crear funciones de búsqueda de conversaciones. |
| entities | object | Entidades extraídas del texto del MD. | Proporciona información adicional sobre hashtags, URL, menciones, etc. |
| sender_id | string | ID del usuario que crea el evento. Para expandir este objeto en la respuesta, incluye sender_id como una expansión y usa el parámetro de consulta user.fields para especificar los atributos del objeto de usuario de interés. ”sender_id”: “906948460078698496” | Recupera el objeto de usuario de quien creó el evento MessageCreate o ParticipantsJoin. |
| participant_ids | array (of strings) | IDs de los participantes que se unen y salen de una conversación grupal. También se usa al crear nuevas conversaciones grupales. Para expandir este objeto en la respuesta, incluye participant_ids como una expansión y usa el parámetro de consulta user.fields para especificar los atributos del objeto de usuario de interés. ”participant_ids”: [ “906948460078698496” ] | Se usa para recuperar objetos de usuario de participantes que se unen y salen de conversaciones grupales. |
| dm_conversation_id | string | El identificador único de la conversación de la que forma parte el evento. ”dm_conversation_id”: “1584988213961031680” | Úsalo para recuperar de forma programática eventos de una conversación y añadir Mensajes Directos a ella. |
| created_at | date (ISO 8601) | Hora de creación (UTC) del Tweet. ”created_at”: “2019-06-04T23:12:08.000Z” | Este campo puede usarse para entender cuándo se creó un Mensaje Directo o cuándo los participantes de la conversación se unieron o se fueron. |
| referenced_tweets | array | ID de cualquier Tweet mencionado en el texto del Mensaje Directo. Para expandir este objeto en la respuesta, incluye referenced_tweets.id como una expansión y usa el parámetro de consulta tweet.fields para especificar los atributos del objeto Tweet de interés. ”referenced_tweets”: [ “id”: “1578868150510456833” ] | Cuando los Mensajes Directos hacen referencia a un Tweet, estos IDs pueden usarse para consultar los detalles del Tweet. |
| attachments | object | Para Mensajes Directos con contenido multimedia adjunto, proporciona la media key del contenido cargado (foto, video o GIF). Para expandir este objeto en la respuesta, incluye attachments.media_keys como una expansión y usa el parámetro de consulta media.fields para especificar los atributos del objeto multimedia de interés. Actualmente, se admite un adjunto. “attachments”: “media_keys”: [ “3_1136048009270239232” ] | Para entender los objetos multimedia adjuntos a los Mensajes Directos. |
- Atributos fundamentales del evento, como cuándo se creó y de qué conversación forma parte (dm_conversation).
- El ID de la cuenta y la descripción de quien envió el Mensaje Directo.
- El texto de cualquier Tweet referenciado y cuándo se publicó.
- El ID de la cuenta y la descripción de cualquier autor de Tweet referenciado.
?dm_event.fields=id,sender_id,text,created_at,dm_conversation_id&expansions=sender_id,referenced_tweets.id&tweet.fields=created_at,text,author_id&user.fields=description
Community
| Valor del campo | Type | Descripción | |
|---|---|---|---|
| created_at | date (ISO 8601) | Fecha y hora de creación de la Comunidad. | |
| id | string | Identificador único de la Comunidad. | |
| name | string | Nombre de la Comunidad. | |
| description | string | Texto de la descripción de la Comunidad, si se proporciona. | |
| access | string | Nivel de acceso de la Comunidad. Puede ser uno de: | |
- Public | |||
- Closed | |||
| join_policy | string | Política de acceso a la Comunidad. Puede ser una de: | |
- Open | |||
- RestrictedJoinRequestsDisabled | |||
- RestrictedJoinRequestsRequireAdminApproval | |||
- RestrictedJoinRequestsRequireModeratorApproval | |||
- SuperFollowRequired | |||
| member_count | integer | Número de miembros que se han unido a la Comunidad. |
$BEARER_TOKEN por tu propio Bearer Token generado.
Cómo usar fields y expansions
fields y expansions en su solicitud para recibir objetos y campos adicionales en su respuesta.
En esta guía, solicitaremos varios campos en la siguiente captura de pantalla de un Tweet.
Solicitar fields y objetos adicionales.
- Identifique los campos adicionales que desea solicitar utilizando nuestro modelo de objetos o revisando la lista de fields en las páginas de referencia de la API de los endpoint. En este caso, solicitaremos los siguientes fields adicionales: attachments, author_id, created_at, public_metrics.
-
Construye el parámetro de consulta
tweet.fieldscon los campos anteriores como valor, usando una lista separada por comas:?tweet.fields=attachments,author_id,created_at,public_metrics - Añade el parámetro query a la solicitud GET /tweets que realizaste anteriormente.
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics' \ --header 'Authorization: Bearer $BEARER_TOKEN'
Respuesta:
- A continuación, vamos a solicitar campos relacionados con el video que se incluyó en el Tweet. Para ello, usaremos el parámetro
expansionsconattachments.media_keyscomo valor, y lo añadiremos a la solicitud.
- Y finalmente, vamos a solicitar el recuento de visualizaciones y la duración del video. Estos no son campos predeterminados, por lo que tenemos que solicitarlos específicamente. Usa el parámetro
media.fieldscon los valores separados por comas,public_metricsyduration_msen tu solicitud.
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics&expansions=attachments.media_keys&media.fields=duration_ms,public_metrics' --header 'Authorization: Bearer $BEARER_TOKEN'
Respuesta, que ahora incluye todos los datos que se pueden ver en la captura de pantalla del Tweet:
- ids=1260294888811347969
- tweet.fields=attachments,author_id,created_at,public_metrics
- expansions=attachments.media_keys
- media.fields=public_metrics,duration_ms