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ón | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar fotos y videos en Flickr Busca fotos o videos públicos de Flickr mediante | keyword | media_type, sort | Entrega síncrona | El 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 solicitudes | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
user_postsListar medios de un usuario Obtiene medios de un | user_id | author_id, media_type, sort, username | Entrega síncrona | El 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 solicitudes | id · 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) oall(todos). El valor por defecto esphotosparasearchyallparauser_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-descointerestingness-asc(interés),date-posted-descodate-posted-asc(fecha de subida) ydate-taken-descodate-taken-asc(fecha de captura). El valor por defecto esrelevanceparasearchydate-posted-descparauser_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 delauthor_iden 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 media_typeOpcional- Tipo de medio:
photos(solo fotos),videos(solo vídeos) oall(todos). El valor por defecto esphotosparasearchyallparauser_posts. Este parámetro no indica si se descargan los archivos originales. sortOpcional- Orden de las fotos o vídeos:
relevance(relevancia),interestingness-descointerestingness-asc(interés),date-posted-descodate-posted-asc(fecha de subida) ydate-taken-descodate-taken-asc(fecha de captura). El valor por defecto esrelevanceparasearchydate-posted-descparauser_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 deuser_postsdeben incluir igualmente eluser_idobligatorio.
Cómo usar la API de Flickr
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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.