Introducción

Configuración de la cuenta

Para acceder a estos endpoints, necesitarás:

• Una cuenta de desarrollador aprobada.
• Autenticarse con las keys and tokens de una App de desarrollador que esté 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](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token), o Código de autorización de OAuth 2.0 con PKCE.  

​

Realizar una solicitud

Puede 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": "Público",
        "description": "¡Bienvenidos a la Comunidad de Anime! Donde los fanáticos del anime se reúnen para compartir sus series favoritas y discutir todo lo relacionado con el anime.",
        "join_policy": "Abierto",
        "name": "Comunidad de Anime"
    }
}

​

Campos de la comunidad

Puede obtener datos adicionales asociados a una comunidad especificando Community Fields.

Los siguientes Community Fields están disponibles:

Valor del campo	Type	Descripción
created_at	date (ISO 8601)	Fecha y hora de creación de la comunidad.
id	string	El identificador único de la comunidad.
name	string	El nombre de la comunidad.
description	string	El texto de la descripción de la comunidad, si está disponible.
access	string	El nivel de acceso de la comunidad. Puede ser uno de: * Public * Closed
join_policy	string	La política de incorporación a la comunidad. Puede ser una de: * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	La cantidad de miembros que se han unido a la comunidad.

​

Ejemplo de solicitud

Puede invocar el 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, verás la respuesta JSON como se muestra a continuación:

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