Introducción

Configuración de la cuenta

Para acceder a estos endpoints, necesitarás:

• Una cuenta de desarrollador aprobada.
• Autenticación con las claves y los tokens de una App de desarrollador que se encuentra dentro de un Project.

Obtén más información sobre cómo obtener acceso a los endpoints de X API v2 en nuestra guía de introducción.

Primeros pasos

​

Autenticación

Puedes autenticar este endpoint con Contexto de usuario de OAuth 1.0a, OAuth 2.0 App-Only, o Código de autorización de OAuth 2.0 con PKCE.  

​

Hacer una solicitud

Puedes invocar el endpoint Communities Lookup proporcionando un id, como se muestra a continuación (usando el id 1758747817642700922):

      curl --location 'https://api.x.com/2/communities/1758747817642700922' --header 'Authorization: ••••••'

Si la solicitud se realiza correctamente, deberías ver la respuesta JSON como se muestra a continuación:

{
    "data": {
        "access": "Public",
        "description": "¡Bienvenido a la Comunidad de Anime! Aquí los fanáticos del anime se reúnen para compartir sus series favoritas y conversar sobre todo lo relacionado con el anime.",
        "join_policy": "Open",
        "name": "Comunidad de Anime"
    }
}

​

Campos de la Comunidad

Puedes obtener datos adicionales asociados con una comunidad especificando los campos de la Comunidad.

Están disponibles los siguientes campos de la Comunidad:

Valor del campo	Tipo	Descripción
created_at	date (ISO 8601)	Fecha 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 está disponible.
access	string	Nivel de acceso de la Comunidad. Puede ser uno de: * Public * Closed
join_policy	string	Política de incorporación de 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.

​

Ejemplo de solicitud

Puedes llamar al endpoint Communities Lookup con campos adicionales de la comunidad, como se muestra a continuación (usando el id 1758747817642700922):

curl --location 'https://api.x.com/2/communities/1758747817642700922?community.fields=access,created_at,description,id,join_policy,member_count,name' --header 'Authorization: ••••••'

Respuesta de ejemplo

Si la solicitud se realiza correctamente, deberías ver la respuesta JSON que se muestra a continuación:

{
    "data": {
        "description": "¡Bienvenido a la Comunidad de Anime! Donde los fans del anime se reúnen para compartir sus series favoritas y hablar de todo lo relacionado con el anime.",
        "access": "Pública",
        "member_count": 40369,
        "created_at": "2024-02-17T06:58:50.000Z",
        "join_policy": "Abierta",
        "name": "Comunidad de Anime",
        "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI="
    }
}