API de Historias de Snapchat

POST

Salud de la API

Salud 24 h
Normal
Tiempo medio 24 h
—
Última comprobación
26 de septiembre de 2026 a las 18:04 (UTC)
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
API de saludNormal
Cómo se mide la salud
  • Salud = porcentaje de llamadas que devolvieron datos. Los resultados vacíos, los fallos y los resultados desconocidos no cuentan como datos devueltos.
  • Niveles: desde 90 % saludable, desde 70 % disponible, desde 40 % limitada; por debajo, casi sin servicio.
  • Un periodo (las últimas 24 horas, una hora o un día) solo se puntúa a partir de 50 llamadas. Los periodos con menos llamadas se muestran como normales: unos pocos fallos entre pocas llamadas no significan que la API esté caída.
  • Las llamadas incluyen las reales de clientes y nuestras llamadas de sondeo diarias. Los errores de la propia solicitud (parámetros incorrectos, saldo insuficiente) no se cuentan.
  • El tiempo medio solo cuenta las llamadas que terminaron con normalidad: tiempo de respuesta en las síncronas; de la aceptación a la finalización en las asíncronas.
Por periodo
Hora (UTC)EstadoSaludTiempo medio
2026-09-26 18:00 - 18:59Normal——
2026-09-26 17:00 - 17:59Normal——
2026-09-26 16:00 - 16:59Normal——
2026-09-26 15:00 - 15:59Normal——
2026-09-26 14:00 - 14:59Normal——
2026-09-26 13:00 - 13:59Normal——
2026-09-26 12:00 - 12:59Normal——
2026-09-26 11:00 - 11:59Normal——
2026-09-26 10:00 - 10:59Normal——
2026-09-26 09:00 - 09:59Normal——
2026-09-26 08:00 - 08:59Normal——
2026-09-26 07:00 - 07:59Normal——
2026-09-26 06:00 - 06:59Normal——
2026-09-26 05:00 - 05:59Normal——
2026-09-26 04:00 - 04:59Normal——
2026-09-26 03:00 - 03:59Normal——
2026-09-26 02:00 - 02:59Normal——
2026-09-26 01:00 - 01:59Normal——
2026-09-26 00:00 - 00:59Normal——
2026-09-25 23:00 - 23:59Normal——
2026-09-25 22:00 - 22:59Normal——
2026-09-25 21:00 - 21:59Normal——
2026-09-25 20:00 - 20:59Normal——
2026-09-25 19:00 - 19:59Normal——
2026-09-26Normal——
2026-09-25Normal——
2026-09-24Normal——
2026-09-23Normal——
2026-09-22Normal——
2026-09-21Normal——
2026-09-20Normal——
2026-09-19Normal——
2026-09-18Normal——
2026-09-17Normal——
2026-09-16Normal——
2026-09-15Normal——
2026-09-14Normal——
2026-09-13Normal——
2026-09-12Normal——
2026-09-11Normal——
2026-09-10Normal——
2026-09-09Normal——
2026-09-08Normal——
2026-09-07Normal——
2026-09-06Normal——
2026-09-05Normal——
2026-09-04Normal——
2026-09-03Normal——
2026-09-02Normal——
2026-09-01Normal——
2026-08-31Normal——
2026-08-30Normal——
2026-08-29Normal——
2026-08-28Normal——

Consulta Stories públicas del username, conservando medio, miniatura, autor y fecha. La respuesta no garantiza todo el periodo de disponibilidad ni descarga contenido privado.

Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Parámetros de la solicitud

NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSísnapchatIdentificador de la plataforma, valor fijo.
actionbodystringSístoriesIdentificador de la capacidad, valor fijo.
usernamebody.paramsNo declaradoSí-Nombre corto de una cuenta de creador pública. Puedes usar el formato @usuario o un enlace como snapchat.com/add/usuario o snapchat.com/@usuario. La acción profile obtiene el perfil público, stories obtiene las historias públicas actuales y user_posts obtiene los vídeos cortos de Spotlight. No lee chats privados ni historias visibles solo para amigos.
limitbody.paramsinteger (1–)No-

Ejemplos de código

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "snapchat",
  "action": "stories",
  "params": {
    "username": "fcbarcelona"
  }
}'

[Definición OpenAPI (JSON)]Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Respuesta real

Obtenida el 26 de septiembre de 2026 a las 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json
{
  "id": "req_…",
  "platform": "snapchat",
  "action": "stories",
  "results": [
    {
      "id": "55a4f40c",
      "story_id": "940c30d9",
      "story_title": "🌕🔵🔴",
      "media_url": "https://cf-st.sc-cdn.net/d/va9S7MHI1eESZ2IkPIyMA.1322.IRZXSOY?mo=GloaGBoAGgAyAQQ6AX1CBgipn8O4BkgCUF5gAVoHRGZNZWRpYaIBMAiqChIeChwgAUoWChEWCQoRCw0HCDgJBgUEBAMEAxD0A2gCIgsSACoHSVJaWFNPWZADgEY%3D&uc=94",
      "thumbnail_url": "https://cf-st.sc-cdn.net/d/va9S7MHI1eESZ2IkPIyMA.410.IRZXSOY?mo=Gj8aGBoAGgAyAQQ6AX1CBgipn8O4BkgCUF5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiaAyILEgAqB0lSWlhTT1k%3D&uc=94",
      "posted_at": "2024-10-16T19:01:13+00:00",
      "username": "fcbarcelona",
      "author_name": "(已隐去)",
      "author_url": "https://www.snapchat.com/(已隐去)",
      "platform": "snapchat"
    },
    {
      "id": "3ae0411b",
      "story_id": "940c30d9",
      "story_title": "🌕🔵🔴",
      "media_url": "https://cf-st.sc-cdn.net/d/Q7KdutN2Y4OFTig0I9VlX.1322.IRZXSOY?mo=GloaGBoAGgAyAQQ6AX1CBgion8O4BkgCUF5gAVoHRGZNZWRpYaIBMAiqChIeChwgAUoWChEYDAwTDA8JCjoKBwYEBQQEBRD0A2gCIgsSACoHSVJaWFNPWZADgEY%3D&uc=94",
      "thumbnail_url": "https://cf-st.sc-cdn.net/d/Q7KdutN2Y4OFTig0I9VlX.410.IRZXSOY?mo=Gj8aGBoAGgAyAQQ6AX1CBgion8O4BkgCUF5gAVoQRGZMYXJnZVRodW1ibmFpbKIBEAiaAyILEgAqB0lSWlhTT1k%3D&uc=94",
      "posted_at": "2024-10-15T16:39:33+00:00",
      "username": "fcbarcelona",
      "author_name": "(已隐去)",
      "author_url": "https://www.snapchat.com/(已隐去)",
      "platform": "snapchat"
    }
  ],
  "count": 203,
  "billing": { … },
  "quota": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la fuente no ofrece nunca se inventan.

CampoSignificado
idIdentificador único del registro en la plataforma de origen. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
story_idConserva el significado de la plataforma
story_titleConserva el significado de la plataforma
media_urlConserva el significado de la plataforma
thumbnail_urlEnlace a la miniatura, con menos resolución que image_url.
posted_atFecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica.
usernameNombre de usuario (@usuario).
author_nameNombre visible del autor.
author_urlEnlace al perfil del autor en la plataforma de origen.
platformIdentificador de la plataforma de origen, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

401
Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422
Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402
Saldo insuficiente. Recarga primero.
429
Se alcanzó el límite de solicitudes por minuto. Espera lo que indique Retry-After y vuelve a intentarlo.
503
No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío
La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).

Referencias oficiales

Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.

  • Snapchat: límites entre `Public Stories` y `My Story · Friends` ↗

    La documentación oficial aclara que las `Public Stories` activas se pueden ver desde el perfil, mientras que `My Story · Friends` solo es visible para amigos. EveryInfra únicamente abarca el alcance actual de las historias públicas, sin garantizar la lectura de historias de amigos ni de recursos caducados.

    Comprobado el 2026-09-04