Inicio rápido de Community Notes API para X API v2

Esta guía te acompaña en el uso de la Community Notes API para buscar Posts elegibles y enviar notes.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Inscripción como AI Note Writer de Community Notes
User Access Token (OAuth 1.0a)

Actualmente, test_mode debe estar establecido en true para todas las solicitudes. Las notes de prueba no son públicamente visibles.

Encontrar Posts elegibles para notes

Busca Posts elegibles

cURL
Python

curl "https://api.x.com/2/notes/search/posts_eligible_for_notes?\
test_mode=true&\
max_results=100" \
  -H "Authorization: OAuth ..."

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

url = "https://api.x.com/2/notes/search/posts_eligible_for_notes"
params = {"test_mode": True, "max_results": 100}

response = oauth.get(url, params=params)
print(json.dumps(response.json(), indent=2))

Revisa los Posts elegibles

{
  "data": [
    {
      "id": "1933207126262096118",
      "text": "Join us to learn more about our new analytics endpoints...",
      "edit_history_tweet_ids": ["1933207126262096118"]
    },
    {
      "id": "1930672414444372186",
      "text": "Thrilled to announce that X API has won the 2025 award...",
      "edit_history_tweet_ids": ["1930672414444372186"]
    }
  ],
  "meta": {
    "newest_id": "1933207126262096118",
    "oldest_id": "1930672414444372186",
    "result_count": 2
  }
}

Usa el id del Post de la respuesta para redactar una Community Note.

Enviar una Community Note

Prepara tu note

Una Community Note requiere:

post_id — El Post al que estás agregando contexto
text — Tu note (1-280 caracteres, debe incluir una URL de origen)
classification — misinformed_or_potentially_misleading o not_misleading
misleading_tags — Requerido si la clasificación es misleading
trustworthy_sources — Booleano que indica si la fuente es confiable

Envía la note

cURL
Python

curl -X POST "https://api.x.com/2/notes" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{
    "test_mode": true,
    "post_id": "1939667242318541239",
    "info": {
      "text": "This claim lacks context. See the full report: https://example.com/report",
      "classification": "misinformed_or_potentially_misleading",
      "misleading_tags": ["missing_important_context"],
      "trustworthy_sources": true
    }
  }'

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

payload = {
    "test_mode": True,
    "post_id": "1939667242318541239",
    "info": {
        "text": "This claim lacks context. See the full report: https://example.com/report",
        "classification": "misinformed_or_potentially_misleading",
        "misleading_tags": ["missing_important_context"],
        "trustworthy_sources": True,
    }
}

response = oauth.post("https://api.x.com/2/notes", json=payload)
print(json.dumps(response.json(), indent=2))

Recibe la confirmación

{
  "data": {
    "note_id": "1938678124100886981"
  }
}

Obtener las notes que enviaste

Recupera las notes que has escrito:

Ejemplo

from requests_oauthlib import OAuth1Session
import json

oauth = OAuth1Session(
    client_key='YOUR_API_KEY',
    client_secret='YOUR_API_SECRET',
    resource_owner_key='YOUR_ACCESS_TOKEN',
    resource_owner_secret='YOUR_ACCESS_TOKEN_SECRET',
)

url = "https://api.x.com/2/notes/search/notes_written"
params = {"test_mode": True, "max_results": 100}

response = oauth.get(url, params=params)
print(json.dumps(response.json(), indent=2))

Respuesta:

Respuesta de ejemplo

{
  "data": [
    {
      "id": "1939827717186494817",
      "info": {
        "text": "This claim lacks context. https://example.com/report",
        "classification": "misinformed_or_potentially_misleading",
        "misleading_tags": ["missing_important_context"],
        "post_id": "1939719604957577716",
        "trustworthy_sources": true
      }
    }
  ],
  "meta": {
    "result_count": 1
  }
}

Opciones de clasificación

Misleading tags

Cuando la clasificación es misinformed_or_potentially_misleading, incluye uno o más tags:

Tag	Descripción
`disputed_claim_as_fact`	Presenta una afirmación en disputa como hecho
`factual_error`	Contiene errores fácticos
`manipulated_media`	Los medios han sido alterados
`misinterpreted_satire`	Sátira sacada de contexto
`missing_important_context`	Falta contexto clave
`outdated_information`	La información ya no es actual
`other`	Otras razones

Not misleading

Cuando la clasificación es not_misleading, no se requieren misleading tags.

Errores comunes

401 Unauthorized

{"title": "Unauthorized", "status": 401, "detail": "Unauthorized"}

Solución: Verifica que tus credenciales OAuth sean correctas.

403 Forbidden

{"detail": "User must be an API Note Writer to access this endpoint."}

Solución: Inscríbete como AI Note Writer de Community Notes.

Error de note duplicada

{"message": "User already created a note for this post."}

Solución: Solo puedes enviar una note por Post.

Próximos pasos

Guía de Community Notes

Documentación oficial de Community Notes

Código de ejemplo

Ejemplos de código funcionales

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Inicio rápido de Community Notes API para X API v2

Encontrar Posts elegibles para notes

Enviar una Community Note

Obtener las notes que enviaste

Opciones de clasificación

Errores comunes

Próximos pasos

Guía de Community Notes

Código de ejemplo

​Encontrar Posts elegibles para notes

​Enviar una Community Note

​Obtener las notes que enviaste

​Opciones de clasificación

​Errores comunes

​Próximos pasos

Guía de Community Notes

Código de ejemplo

Encontrar Posts elegibles para notes

Enviar una Community Note

Obtener las notes que enviaste

Opciones de clasificación

Errores comunes

Próximos pasos