API Flickr
Ищите публичные фото и видео или просматривайте материалы, загруженные автором, вместе с метаданными для систематизации визуальных исследований.
Чтобы получить материалы, загруженные конкретным автором, используйте NSID этого автора в Flickr. Отображаемое имя не является тем же идентификатором.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Flickr: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите на Flickr фото или видео по keyword. | $24 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Выводите фото и видео участника Flickr по его NSID в user_id: названия, ссылки на изображения, теги, дату съёмки и дату загрузки. | $24 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Flickr?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите на Flickr фото или видео по | keyword | media_type, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $24 за 1 000 запросов | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
user_postsПосты пользователя Выводите фото и видео участника Flickr по его NSID в | user_id | author_id, media_type, sort, username | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $24 за 1 000 запросов | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
Что означают параметры действия search в API Flickr?
Ищите на Flickr фото или видео по keyword. Получайте название, ссылку на изображение, теги, имя и ID фотографа, дату съёмки и дату загрузки. taken_at берётся из EXIF, может быть пустым и отличается от времени загрузки. Ссылка не даёт прав на повторное использование.
keywordОбязательный- Поисковый запрос по фото или видео в действии search. Тип возвращаемых медиа задаётся параметром media_type; точный поиск по отображаемому имени автора этот параметр не выполняет.
media_typeНеобязательный- Фильтрует тип медиа; допустимые значения: photos (только фото), videos (только видео) или all (все медиа). По умолчанию photos в search и all в user_posts. Параметр управляет фильтрацией запроса и не определяет, скачиваются ли исходные файлы.Flickr: тип медиа и лицензия на контент — разные вещи — Flickr явно разделяет определения типов медиа и классификацию лицензий. Сейчас EveryInfra поддерживает параметр `media_type`, но не предоставляет официальные параметры лицензий. Получение фото или видео через поиск не даёт прав на их использование. · Проверено
sortНеобязательный- Сортирует фото и видео в search (по умолчанию relevance) и user_posts (по умолчанию date-posted-desc). Поддерживаются, в частности, значения relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc и date-taken-asc. Дата загрузки (date-posted) и дата съёмки (date-taken) являются разными атрибутами и не взаимозаменяемы.Flickr: сортировка по дате съёмки и по дате публикации — Документация Flickr различает сортировку по дате съёмки (date-taken) и по дате публикации (date-posted). Это проясняет смысл временных меток, но значения по умолчанию, поддерживаемые параметры и максимальное число результатов этого эндпоинта определяются документацией EveryInfra и не повторяют все возможности официального API. · Проверено
Что означают параметры действия user_posts в API Flickr?
Выводите фото и видео участника Flickr по его NSID в user_id: названия, ссылки на изображения, теги, дату съёмки и дату загрузки. Передавайте NSID из поля author_id результата поиска, а не отображаемое имя. Закрытые альбомы не включаются.
user_idОбязательный- NSID целевого пользователя Flickr, например 12345678@N04; его можно взять из поля author_id в результатах поиска. Отображаемые имена, псевдонимы профиля и полные URL профилей не принимаются.Flickr: что означает NSID пользователя — Документация Flickr определяет `user_id` как NSID пользователя, который отличается от отображаемого имени и пути в пользовательском URL профиля. Это определение не означает, что EveryInfra имеет доступ к закрытым фотографиям пользователя. · Проверено
media_typeНеобязательный- Фильтрует тип медиа; допустимые значения: photos (только фото), videos (только видео) или all (все медиа). По умолчанию photos в search и all в user_posts. Параметр управляет фильтрацией запроса и не определяет, скачиваются ли исходные файлы.
sortНеобязательный- Сортирует фото и видео в search (по умолчанию relevance) и user_posts (по умолчанию date-posted-desc). Поддерживаются, в частности, значения relevance, interestingness-desc, interestingness-asc, date-posted-desc, date-posted-asc, date-taken-desc и date-taken-asc. Дата загрузки (date-posted) и дата съёмки (date-taken) являются разными атрибутами и не взаимозаменяемы.
usernameНеобязательный- Псевдоним user_id для совместимости в user_posts. Требует действительный NSID Flickr, а не отображаемое имя; в публичных запросах user_posts обязательный параметр user_id по-прежнему нужен.
Как использовать API Flickr
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
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>"}}'
Вопросы об API Flickr
Какие данные можно получить через API Flickr?
Укажите в platform значение flickr. В текущем каталоге: поиск и посты пользователя. Эти названия действий соответствуют разным объектам или представлениям Flickr; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Flickr?
Поисковый запрос по фото или видео в действии search. Тип возвращаемых медиа задаётся параметром media_type; точный поиск по отображаемому имени автора этот параметр не выполняет. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Flickr?
Объявленная схема включает title, image_url, media_type и author_name. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Flickr возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.