# Obtener cronología de tweets de la lista

**API:** Data API

**Endpoint:** `GET /v1/beta/twitter/list/tweets_timeline`

**Tags:** Twitter / X

Obtiene la cronología de tweets de una X List por `listId`, hasta 20 por página, con paginación por cursor. Devuelve tweets con `has_next_page` y `next_cursor`. Para ver quién está en la List, usa `get_twitter_list_members`.

### Referencia de precios

- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.0015.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string |  |
| `listId` | query | no | string |  |

## Responses

### 200 — Respuesta de la cronología de tweets de la lista

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: `ResponseA06878E34984_ListTweetsTimelineResponse` (`#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse`)

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseA06878E34984_ListTweetsTimelineResponse

`#/components/schemas/ResponseA06878E34984_ListTweetsTimelineResponse`

```json
{
  "type": "object",
  "properties": {
    "tweets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseA06878E34984_Tweet"
      },
      "description": "Array de tweets de la lista"
    },
    "has_next_page": {
      "type": "boolean",
      "description": "Indica si hay más resultados disponibles"
    },
    "next_cursor": {
      "type": "string",
      "description": "Cursor para obtener la siguiente página de resultados"
    },
    "status": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ],
      "example": "success",
      "description": "Estado de la solicitud"
    },
    "msg": {
      "type": "string",
      "description": "Mensaje de la solicitud, mensaje de error si el status es error"
    }
  }
}
```

### ResponseA06878E34984_Tweet

`#/components/schemas/ResponseA06878E34984_Tweet`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "description": "El ID del tweet"
    },
    "url": {
      "type": "string",
      "description": "La URL del tweet"
    },
    "text": {
      "type": "string",
      "description": "El texto del tweet"
    },
    "source": {
      "type": "string",
      "description": "El cliente de origen del tweet"
    },
    "retweetCount": {
      "type": "integer"
    },
    "replyCount": {
      "type": "integer"
    },
    "likeCount": {
      "type": "integer"
    },
    "quoteCount": {
      "type": "integer"
    },
    "viewCount": {
      "type": "integer"
    },
    "createdAt": {
      "type": "string",
      "description": "La fecha y hora de creación del tweet"
    },
    "lang": {
      "type": "string",
      "description": "El idioma del tweet"
    },
    "bookmarkCount": {
      "type": "integer"
    },
    "isReply": {
      "type": "boolean"
    },
    "inReplyToId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "inReplyToUserId": {
      "type": "string"
    },
    "inReplyToUsername": {
      "type": "string"
    },
    "author": {
      "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUser"
    }
  }
}
```

### ResponseA06878E34984_TwitterUrl

`#/components/schemas/ResponseA06878E34984_TwitterUrl`

```json
{
  "type": "object",
  "properties": {
    "display_url": {
      "type": "string",
      "description": "URL de visualización"
    },
    "expanded_url": {
      "type": "string",
      "description": "URL expandida"
    },
    "indices": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Índices de la URL"
    },
    "url": {
      "type": "string",
      "description": "URL"
    }
  }
}
```

### ResponseA06878E34984_TwitterUser

`#/components/schemas/ResponseA06878E34984_TwitterUser`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Tipo de usuario"
    },
    "userName": {
      "type": "string",
      "description": "Nombre de usuario"
    },
    "url": {
      "type": "string",
      "description": "URL del perfil del usuario"
    },
    "id": {
      "type": "string",
      "description": "ID del usuario"
    },
    "name": {
      "type": "string",
      "description": "Nombre del usuario"
    },
    "isBlueVerified": {
      "type": "boolean",
      "description": "Indica si el usuario tiene verificación azul"
    },
    "verifiedType": {
      "type": "string",
      "description": "Tipo de verificación"
    },
    "profilePicture": {
      "type": "string",
      "description": "URL de la foto de perfil"
    },
    "coverPicture": {
      "type": "string",
      "description": "URL de la imagen de portada"
    },
    "description": {
      "type": "string",
      "description": "Descripción del usuario"
    },
    "location": {
      "type": "string",
      "description": "Ubicación del usuario"
    },
    "followers": {
      "type": "integer",
      "description": "Número de seguidores"
    },
    "following": {
      "type": "integer",
      "description": "Número de seguidos"
    },
    "canDm": {
      "type": "boolean",
      "description": "Indica si el usuario puede recibir mensajes directos"
    },
    "createdAt": {
      "type": "string",
      "description": "Fecha de creación de la cuenta"
    },
    "favouritesCount": {
      "type": "integer",
      "description": "Número de favoritos"
    },
    "hasCustomTimelines": {
      "type": "boolean",
      "description": "Indica si el usuario tiene líneas de tiempo personalizadas"
    },
    "isTranslator": {
      "type": "boolean",
      "description": "Indica si el usuario es traductor"
    },
    "mediaCount": {
      "type": "integer",
      "description": "Número de elementos multimedia"
    },
    "statusesCount": {
      "type": "integer",
      "description": "Número de estados"
    },
    "withheldInCountries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Lista de países donde se retiene el contenido del usuario"
    },
    "possiblySensitive": {
      "type": "boolean",
      "description": "Indica si el usuario tiene contenido sensible"
    },
    "pinnedTweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Lista de ID de tweets fijados"
    },
    "isAutomated": {
      "type": "boolean",
      "description": "Indica si la cuenta está automatizada"
    },
    "automatedBy": {
      "type": "string",
      "description": "Indica quién automatizó la cuenta"
    },
    "unavailable": {
      "type": "boolean",
      "description": "Indica si la cuenta no está disponible"
    },
    "message": {
      "type": "string",
      "description": "Mensaje sobre la cuenta"
    },
    "unavailableReason": {
      "type": "string",
      "description": "Motivo de la indisponibilidad"
    },
    "profile_bio": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "Descripción de la biografía"
        },
        "entities": {
          "type": "object",
          "properties": {
            "description": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl"
                  }
                }
              }
            },
            "url": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ResponseA06878E34984_TwitterUrl"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```
