API de plataforma de EveryData

API de Flickr

Busca fotos y videos públicos de Flickr y consulta las publicaciones de un usuario conocido. La respuesta conserva autor, tipo de medio y fechas de captura y publicación.

Etiquetas y métricas ayudan a describir el medio, pero no verifican su tema ni conceden derechos de reutilización. Las colecciones privadas y el archivo completo quedan fuera del contrato.

Endpoint
POST /api/v1/social
Funciones
2
Por 1.000
1,389 US$

Funciones disponibles

Compara las acciones de Flickr por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

AcciónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar fotos y videos en Flickr

Busca fotos o videos públicos de Flickr mediante keyword, con tipo de medio y orden opcionales. Conserva autor, etiquetas y fechas de captura y publicación; el enlace no concede derechos de reutilización.

keywordmedia_type, sortEntrega síncronaEl catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.$1.39 por 1.000 solicitudesid · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform
user_posts

Listar medios de un usuario

Obtiene medios de un user_id, con alias compatibles de autor o usuario, y permite filtrar tipo u orden. No incluye álbumes privados ni garantiza el archivo completo de la cuenta.

user_idauthor_id, media_type, sort, usernameEntrega síncronaEl catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.$1.39 por 1.000 solicitudesid · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform

¿Qué acepta cada acción de Flickr?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

¿Qué significan los parámetros de Flickr search?

Busca fotos o videos públicos de Flickr mediante keyword, con tipo de medio y orden opcionales. Conserva autor, etiquetas y fechas de captura y publicación; el enlace no concede derechos de reutilización.

keywordObligatorio
Término de búsqueda de fotos o vídeos en Flickr. El tipo de medio lo determina media_type. No es una búsqueda exacta por el alias del autor.
media_typeOpcional
Tipo de medio: photos (solo fotos), videos (solo vídeos) o all (todos). El valor por defecto es photos para search y all para user_posts. Este parámetro no indica si se descargan los archivos originales.
Flickr: el tipo de medio y la licencia de la obra son conceptos distintosLa documentación oficial de Flickr define el tipo de medio y la `license` por separado. Esta consulta ofrece el parámetro `media_type`, pero esto no significa que el parámetro oficial `license` esté disponible. Que una foto o un vídeo aparezca en los resultados no concede una licencia para su uso.Consultada
sortOpcional
Orden de las fotos o vídeos: relevance (relevancia), interestingness-desc o interestingness-asc (interés), date-posted-desc o date-posted-asc (fecha de subida) y date-taken-desc o date-taken-asc (fecha de captura). El valor por defecto es relevance para search y date-posted-desc para user_posts. No confundas la fecha de captura con la de subida.
Flickr: fecha de captura y fecha de publicaciónLa documentación de Flickr distingue los ordenamientos por fecha de captura y por fecha de publicación. Esta referencia aclara el tiempo representado; los valores y límites aceptados siguen siendo los del contrato de EveryInfra.Consultada

¿Qué significan los parámetros de Flickr user_posts?

Obtiene medios de un user_id, con alias compatibles de autor o usuario, y permite filtrar tipo u orden. No incluye álbumes privados ni garantiza el archivo completo de la cuenta.

user_idObligatorio
NSID del usuario de Flickr, como 12345678@N04. Se puede obtener del author_id en los resultados de búsqueda. No es el alias, el nombre corto del perfil ni la URL completa.
Flickr: significado del NSID de usuarioLa documentación oficial de Flickr define el `user_id` como el NSID del usuario. Este identificador no es lo mismo que el alias público o la ruta personalizada de su página. Esta referencia no implica que se puedan consultar las fotos privadas de un usuario.Consultada
author_idOpcional
NSID de Flickr, con formato 12345678@N04. No es el nombre de usuario. Se obtiene del author_id en los resultados de búsqueda.
media_typeOpcional
Tipo de medio: photos (solo fotos), videos (solo vídeos) o all (todos). El valor por defecto es photos para search y all para user_posts. Este parámetro no indica si se descargan los archivos originales.
sortOpcional
Orden de las fotos o vídeos: relevance (relevancia), interestingness-desc o interestingness-asc (interés), date-posted-desc o date-posted-asc (fecha de subida) y date-taken-desc o date-taken-asc (fecha de captura). El valor por defecto es relevance para search y date-posted-desc para user_posts. No confundas la fecha de captura con la de subida.
usernameOpcional
Parámetro compatible con user_id. Actualmente debes enviar el NSID de Flickr, no el nombre de usuario legible. Las peticiones públicas de user_posts deben incluir igualmente el user_id obligatorio.

Cómo usar la API de Flickr

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
flickr_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"flickr","action":"search","params":{"keyword":"<keyword>"}}'

Preguntas sobre la API de Flickr

¿Cómo llamo a la API de Flickr?

Envía POST /api/v1/social con platform igual a flickr, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Flickr?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, image_url, media_type y author_name. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de Flickr?

La documentación de Flickr distingue los ordenamientos por fecha de captura y por fecha de publicación. Esta referencia aclara el tiempo representado; los valores y límites aceptados siguen siendo los del contrato de EveryInfra.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword; user_posts requiere user_id.