社交内容 · 数据 API

Flickr API

图片搜索与摄影师作品流——素材寻源与视觉趋势观察。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Flickr 能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	media_type, sort	默认 10 · 最多 50	同步	$1.39 / 千次	id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform
user_posts	user_id	author_id, media_type, sort, username	默认 10 · 最多 50	同步	$1.39 / 千次	id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform

Flickr 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Flickr 关键词搜索 API？

search

使用 platform="flickr"、action="search" 调用“关键词搜索”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、title、image_url、media_type、author_name 等 11 个字段。

Flickr search 的参数分别是什么意思？

keyword必填: Flickr 照片/视频搜索词；由 media_type 决定媒体范围，不是作者昵称的精确查询。
media_type可选: 媒体范围：photos 仅照片、videos 仅视频、all 全部。search 默认 photos，user_posts 默认 all；这个参数不表示是否下载原始文件。
Flickr 官方把媒体类型与 license 分开定义；EveryInfra 当前提供 media_type，未因此开放官方 license 参数。照片或视频被检索到，不等于授予素材使用许可。官方来源：Flickr：媒体类型与作品许可是两回事来源核查：2026-09-04
sort可选: 照片/视频排序：relevance 相关度；interestingness-desc / interestingness-asc 趣味度从高到低/从低到高；date-posted-desc / date-posted-asc 上传时间从新到旧/从旧到新；date-taken-desc / date-taken-asc 拍摄时间从新到旧/从旧到新。search 默认 relevance，user_posts 默认 date-posted-desc；拍摄与上传日期不能混用。
Flickr 官方文档区分 date-taken 与 date-posted 排序；这里只解释时间含义，本接口的默认值、允许参数及结果上限仍按 EveryInfra 契约，不复制官方 API 的全部能力。官方来源：Flickr：拍摄日期与上传日期排序来源核查：2026-09-04

Flickr 特有返回字段与含义（2）

media_type: 媒体类型（照片/视频）。
taken_at: 拍摄时间，来自照片 EXIF，与上传时间不同，可能为 null。

怎么调用 Flickr 用户内容 API？

user_posts

使用 platform="flickr"、action="user_posts" 调用“用户内容”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、title、image_url、media_type、author_name 等 11 个字段。

Flickr user_posts 的参数分别是什么意思？

user_id必填: Flickr 用户 NSID，例如 12345678@N04，可从搜索结果的 author_id 获取；不是显示昵称、个人主页短名或整条 URL。
Flickr 官方文档将 user_id 定义为用户 NSID；它与显示昵称或自定义主页路径不是同一概念。这里不表示 EveryInfra 可以访问用户私密照片。官方来源：Flickr：用户 NSID 的含义来源核查：2026-09-04
author_id可选: user_id 的低优先级兼容输入，值同样须为 Flickr NSID（形如 12345678@N04，可从搜索结果的 author_id 取得），不是可读用户名。公开 user_posts 请求仍须提供 user_id，且 user_id 会优先于 author_id。
media_type可选: 媒体范围：photos 仅照片、videos 仅视频、all 全部。search 默认 photos，user_posts 默认 all；这个参数不表示是否下载原始文件。
sort可选: 照片/视频排序：relevance 相关度；interestingness-desc / interestingness-asc 趣味度从高到低/从低到高；date-posted-desc / date-posted-asc 上传时间从新到旧/从旧到新；date-taken-desc / date-taken-asc 拍摄时间从新到旧/从旧到新。search 默认 relevance，user_posts 默认 date-posted-desc；拍摄与上传日期不能混用。
username可选: user_id 的兼容输入，当前仍需传 Flickr NSID，而不是可读用户名；公开 user_posts 请求仍需包含必填 user_id。

Flickr 特有返回字段与含义（2）

media_type: 媒体类型（照片/视频）。
taken_at: 拍摄时间，来自照片 EXIF，与上传时间不同，可能为 null。

一次 Flickr search 调用的全过程：向 POST /api/v1/social 发送 platform="flickr"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、image_url、media_type 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

Flickr 原始字段名

EveryInfra 统一字段名

左边是 Flickr 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Flickr 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 1 个字段名只在 Flickr 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

taken_at

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
media_type: 媒体类型（照片/视频）。
author_name: 作者昵称（显示名）。
author_id: 作者在原平台的唯一 ID。
tags: 标签数组。无标签时为空数组，不是 null。
taken_at: 拍摄时间，来自照片 EXIF，与上传时间不同，可能为 null。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

请求填写示例

这里检索公开照片；作者资料使用独立目标参数。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

flickr_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"flickr","action":"search","params":{"keyword":"street photography"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "image_url": null,
  "media_type": null,
  "author_name": null,
  "author_id": null,
  "tags": null,
  "taken_at": null,
  "posted_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

区分 Flickr 拍摄时间与上传时间

搜索照片时按正确的时间字段排序，避免把补传旧照片当作新拍摄。

查看 search 的 sort 参数 →

keyword 搜索照片/视频主题；sort=date-taken-desc 按拍摄时间，date-posted-desc 按上传时间，默认 relevance。taken_at 与 posted_at 应分别保存。
拍摄时间不等于发布时间，缺失日期不自行补齐；tags、title 与 url 可辅助核对素材，当前没有授权类型筛选或完整 EXIF 查询参数。

用 Flickr NSID 读取作者媒体

把搜索结果中的 author_id 用于 user_posts，而不是直接传显示昵称。

查看 user_posts 的 user_id 参数 →

user_id 使用 12345678@N04 这样的 NSID，可从搜索结果 author_id 获取；结合 author_id、author_name、id 与 url 检查作者和作品。
用户名输入也要求 NSID，不能把个人主页短名当作同一标识；默认返回媒体范围为 all，不是仅照片，也不代表该作者全部历史或私密内容。

用 Flickr 媒体类型筛选照片或视频

在发现阶段区分照片和视频，不把媒体链接当作下载与授权交付。

查看 search 的 media_type 参数 →

search 的 media_type 可填 photos、videos、all，默认 photos；返回 media_type 描述记录类型，image_url 是可用的图片展示链接。
视频结果不等于已返回原始视频文件，image_url 也不代表原始分辨率或可商用许可；如需使用素材，应另查目标作品的许可条件。

Flickr API 常见问题

Flickr API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="flickr"、action 和 params。以 search 为例，必填 keyword，可选 media_type、sort。这里检索公开照片；作者资料使用独立目标参数。 Flickr 共 2 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Flickr API 怎么收费？

$1.39 / 千次，Flickr 全部 2 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Flickr 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Flickr API 一次能返回多少条数据？

Flickr 有 2 个列表接口，包括 search、user_posts。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Flickr API 返回哪些字段？

当前目录为 search 列出 id、url、title、image_url、media_type、author_name 等 11 个字段名。按全站当前目录统计，1 个字段名只在 Flickr 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「区分 Flickr 拍摄时间与上传时间」怎样接入 Flickr API？

搜索照片时按正确的时间字段排序，避免把补传旧照片当作新拍摄。 keyword 搜索照片/视频主题；sort=date-taken-desc 按拍摄时间，date-posted-desc 按上传时间，默认 relevance。taken_at 与 posted_at 应分别保存。拍摄时间不等于发布时间，缺失日期不自行补齐；tags、title 与 url 可辅助核对素材，当前没有授权类型筛选或完整 EXIF 查询参数。

「用 Flickr NSID 读取作者媒体」怎样接入 Flickr API？

把搜索结果中的 author_id 用于 user_posts，而不是直接传显示昵称。 user_id 使用 12345678@N04 这样的 NSID，可从搜索结果 author_id 获取；结合 author_id、author_name、id 与 url 检查作者和作品。用户名输入也要求 NSID，不能把个人主页短名当作同一标识；默认返回媒体范围为 all，不是仅照片，也不代表该作者全部历史或私密内容。

「用 Flickr 媒体类型筛选照片或视频」怎样接入 Flickr API？

在发现阶段区分照片和视频，不把媒体链接当作下载与授权交付。 search 的 media_type 可填 photos、videos、all，默认 photos；返回 media_type 描述记录类型，image_url 是可用的图片展示链接。视频结果不等于已返回原始视频文件，image_url 也不代表原始分辨率或可商用许可；如需使用素材，应另查目标作品的许可条件。

可以先免费试用 Flickr API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Flickr 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 2 个能力。无需信用卡。

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 豆瓣 API 抖音 API 全部 89 平台 ↗

开始调用 Flickr API

加微信领 $1 免费额度，先选一个 Flickr 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始