Introduzione

Questo endpoint consente di cercare e scoprire Community in base a parole chiave.

L’endpoint accetta una o più parole chiave come query. Per impostazione predefinita, una richiesta restituirà sia Community pubbliche sia chiuse che corrispondono alla query specificata.

Configurazione dell’account

Per accedere a questi endpoint, avrai bisogno di:

• Un account sviluppatore approvato.
• Di autenticarti utilizzando le chiavi e i token di un’App sviluppatore che si trova all’interno di un Project.

Scopri di più su come ottenere l’accesso agli endpoint della X API v2 nella nostra guida introduttiva.

Guida introduttiva

​

Autenticazione

Puoi autenticare questo endpoint con Contesto utente OAuth 1.0a, [OAuth 2.0 App-Only](https://developer.x.com(/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token), oppure OAuth 2.0 Authorization Code con PKCE.  

​

Effettuare una richiesta

Puoi chiamare l’endpoint Search Communities come mostrato di seguito:

      curl --location 'https://api.x.com/2/communities/search?query=anime' --header 'Authorization: ••••••'

Se la richiesta va a buon fine, vedrai la risposta JSON come mostrato di seguito:

{
   "data": [
       {
           "access": "Public",
           "description": "Benvenuti nella Comunità Anime! Qui i fan degli anime si riuniscono per condividere le loro serie preferite e discutere di tutto ciò che riguarda gli anime.",
           "join_policy": "Open",
           "name": "Anime Community"
       },
       {
           "access": "Public",
           "description": "Unisciti e parla di anime 🥰",
           "join_policy": "Open",
           "name": "Anime World 🌸"
       },
       {
           "access": "Public",
           "description": "Per tutti gli appassionati e creatori di anime!",
           "join_policy": "Open",
           "name": "Anime"
       },
   ],
   "meta": {
       "next_token": "7140dibdnow9c7btw481s8m561gat797rboud5r80xvzm"
   }
}

​

Campi della Community

Puoi recuperare dati aggiuntivi associati a una Community specificando i Community Fields.

Sono disponibili i seguenti Community Fields:

Valore del campo	Type	Descrizione
created_at	date (ISO 8601)	Data e ora di creazione della Community.
id	string	L’identificatore univoco della Community.
name	string	Il nome della Community.
description	string	Il testo della descrizione della Community, se presente.
access	string	Il livello di accesso della Community. Può essere uno dei seguenti: * Public * Closed
join_policy	string	La policy di adesione della Community. Può essere una delle seguenti: * Open * RestrictedJoinRequestsDisabled * RestrictedJoinRequestsRequireAdminApproval * RestrictedJoinRequestsRequireModeratorApproval * SuperFollowRequired
member_count	integer	Il numero di membri che hanno aderito alla Community.

​

Esempio di richiesta

Puoi chiamare l’endpoint Search Communities includendo campi aggiuntivi della community, come mostrato di seguito:

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

Risposta di esempio

Se la richiesta va a buon fine, vedrai la risposta JSON mostrata di seguito:

{
   "data": [
       {
           "id": "Q29tbXVuaXR5OjE3NTg3NDc4MTc2NDI3MDA5MjI=",
           "description": "Benvenuti nella Community Anime! Qui i fan degli anime si riuniscono per condividere le loro serie preferite e discutere di tutto ciò che riguarda gli anime.",
           "join_policy": "Open",
           "access": "Public",
           "member_count": 39915,
           "name": "Community Anime",
           "created_at": "2024-02-17T06:58:50.000Z"
       },
       {
           "id": "Q29tbXVuaXR5OjE1MDY3OTM5NTMxMDYwNDI4OTE=",
           "description": "Unisciti e parla di anime 🥰",
           "join_policy": "Open",
           "access": "Public",
           "member_count": 26019,
           "name": "Mondo Anime 🌸",
           "created_at": "2022-03-24T00:44:07.000Z"
       },
       {
           "id": "Q29tbXVuaXR5OjE0OTY3NzYyMTU5Mzk1MzQ4NDk=",
           "description": "Per tutti gli appassionati e creatori di anime!",
           "join_policy": "Open",
           "access": "Public",
           "member_count": 5612,
           "name": "Anime",
           "created_at": "2022-02-24T09:17:13.000Z"
       }
   ],
   "meta": {
       "next_token": "7140dibdnow9c7btw481s8m561gat797rboud5r80xvzm"
   }
}