Autenticación

Autenticación con token Bearer para Twexapi — úsala con Cursor, Claude Code, GitHub Copilot, ChatGPT y agentes de codificación AI. Comienza en minutos.

Autenticación de la API

Twexapi utiliza autenticación con token Bearer para proteger todas las solicitudes de API. Cada solicitud debe incluir una clave de API válida en el encabezado de Autorización para acceder a nuestros puntos finales.

Obtener tu Clave de API

Sigue estos pasos simples para obtener tu clave de API:

1. Inicia sesión en tu Panel de Control de Twexapi
2. Tu clave de API única se mostrará de manera destacada en la página de inicio del panel de control
3. Copia la clave de manera segura — necesitarás para todas las solicitudes de API

Usar tu Clave de API

Incluye tu clave de API en el encabezado Authorization de cada solicitud utilizando el formato de token Bearer:

Encabezado Requerido:

Authorization: Bearer TU_CLAVE_API

Variable de Entorno

Los SDKs y la CLI leen la misma credencial desde el entorno:

export X_API_SCRAPER_KEY="TU_CLAVE_API"

Usa Authorization: Bearer TU_CLAVE_API en solicitudes HTTP en bruto. Los SDKs generados aceptan opciones como bearer_auth o equivalentes — consulta cada página de SDK.

Autenticarse con el CLI

Instala el CLI oficial, guarda tu clave de API como un perfil de aplicación nombrado y ejecuta comandos sin incrustar secretos en el historial de shell:

npm install -g @twexapi-dev/x-api-scraper-cli

export X_API_SCRAPER_KEY="TU_CLAVE_API"

x-api-scraper auth apps add --name prod --api-key "TU_CLAVE_API"
x-api-scraper auth apps use prod
x-api-scraper --app prod about elonmusk

Referencia completa de comandos: CLI.

Autenticarse con MCP

Conécta a https://api.twexapi.io/mcp con tu clave de API:

{
  "headers": {
    "x-api-key": "TU_CLAVE_API"
  }
}

Algunos clientes aceptan Authorization: Bearer TU_CLAVE_API en su lugar. Consulta Servidor MCP para configuraciones de clientes como Cursor, Claude Code, Codex CLI y otros.

Autenticarse con Agentes de Codificación AI

Instala la habilidad de TwexAPI para que Cursor, Claude Code, GitHub Copilot, ChatGPT, Cline, Windsurf, Codex, Gemini CLI, Continue, Roo Code y otros asistentes AI sepan cómo adjuntar tokens Bearer correctamente. Guías de configuración y opciones de CLI están en el hub de integraciones.

npx skills add twexapi-dev/x-api-scraper-cli

En Cursor, GitHub Copilot, Claude Code, ChatGPT, Continue, Roo Code o cualquier agente compatible, intenta comandos como “configura la autenticación de Twexapi desde mi archivo .env”, “agrega autenticación Bearer a este cliente de API” o “genera una solicitud de prueba con mi clave de API”.

Operaciones de Escritura y BYOC (Tráiger Tus Propias Cookies)

Mientras que todos los puntos finales de lectura pública (buscador, perfiles de usuarios, tuits, seguidores, hilos, tendencias) requieren cero cookies o credenciales de inicio de sesión de Twitter, las operaciones de escritura operan bajo un modelo BYOC (Tráiger Tus Propias Cookies).

Acciones de Escritura Soportadas

• Crear tuits y publicaciones en hilos (POST /twitter/tweets/create, POST /v3/twitter/tweets/create_thread)
• Me gustan y retuits (POST /twitter/tweets/{tweet_id}/like, POST /twitter/tweets/{tweet_id}/retweet)
• Enviar mensajes directos (POST /v3/twitter/send_dm)
• Seguir cuentas (POST /twitter/user/follow)

Ejecución Delegada y Seguridad de Cero Retención

Cómo Autenticar Solicitudes de Escritura

Además del encabezado Authorization: Bearer TU_CLAVE_API, proporciona la cadena de auth_token o cookie de tu cuenta directamente en el cuerpo de la solicitud:

curl -X POST "https://api.twexapi.io/twitter/tweets/create" \
  -H "Authorization: Bearer TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "tweet_text": "¡Hola mundo desde una pipeline automatizada!",
    "cookie": "auth_token=TU_TWITTER_AUTH_TOKEN; ct0=TU_CT0_TOKEN"
  }'

Ejemplos de Implementación

Aquí hay ejemplos prácticos que muestran cómo autenticar tus solicitudes en diferentes lenguajes de programación:

cURL

Perfecto para pruebas y exploración rápida de API:

curl --request GET \
  --url 'https://api.twexapi.io/twitter/users?usernames=elonmusk' \
  --header 'Authorization: Bearer TU_CLAVE_API' \
  --header 'Content-Type: application/json'

Python

Usando la popular biblioteca requests:

import requests

# Punto final de API y parámetros
url = "https://api.twexapi.io/twitter/users"
params = {"usernames": "elonmusk"}

# Encabezado de autenticación
headers = {
    "Authorization": "Bearer TU_CLAVE_API",
    "Content-Type": "application/json"
}

# Hacer la solicitud
response = requests.get(url, headers=headers, params=params)

# Manejar la respuesta
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error: {response.status_code} - {response.text}")

JavaScript (Node.js/Browser)

Implementación moderna del API fetch:

const fetchUserData = async () => {
  const options = {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer TU_CLAVE_API',
      'Content-Type': 'application/json'
    }
  };

  try {
    const response = await fetch(
      'https://api.twexapi.io/twitter/users?usernames=elonmusk', 
      options
    );
    
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    
    const data = await response.json();
    console.log(data);
  } catch (error) {
    console.error('Request failed:', error);
  }
};

fetchUserData();

Java

Usando Unirest para solicitudes HTTP simplificadas:

import kong.unirest.HttpResponse;
import kong.unirest.Unirest;

public class TwitterApiExample {
    public static void main(String[] args) {
        try {
            HttpResponse<String> response = Unirest
                .get("https://api.twexapi.io/twitter/users?usernames=elonmusk")
                .header("Authorization", "Bearer TU_CLAVE_API")
                .header("Content-Type", "application/json")
                .asString();
            
            if (response.getStatus() == 200) {
                System.out.println(response.getBody());
            } else {
                System.err.println("Error: " + response.getStatus() + " - " + response.getBody());
            }
        } catch (Exception e) {
            System.err.println("Request failed: " + e.getMessage());
        }
    }
}

Prácticas Mejores y Siguientes Pasos

• Variables de Entorno: Almacena tu clave de API en X_API_SCRAPER_KEY o en un administrador de secretos, nunca codifícala en bruto.
• Facturación Transparente: Revisa las tarifas micro-por-solicitud en nuestra Guía de Precios y Facturación.
• Recuperación de Errores: Maneja respuestas 4xx/5xx — consulta Manejo de Errores.
• Límites de Tasa: Reduzca en caso de 429 — consulta Límites de Tasa.
• Lectura Pública Cero-Cookie: Entiende por qué no se necesitan cookies de inicio de sesión públicas en comparación con configuraciones autohosteadas en Scraper Autohosteado vs TwexAPI y Alternativas a Nitter.
• Evaluación de Arquitectura: compara TwexAPI con el API oficial X (pagas por recurso vs por solicitud) en nuestra Comparación del API Oficial X.
• Sólo HTTPS: Todas las solicitudes deben usar HTTPS por seguridad.