プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Flickrの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordに一致するFlickrの写真や動画を検索します。タイトル、画像リンク、タグ、撮影者の名前とID、撮影日、アップロード日を取得できます。taken_atはEXIFに基づく値で、空の場合があり、アップロード日時とは異なります。リンクは再利用の権利を付与するものではありません。 | 1,000リクエストあたり$24 | 正常 |
ユーザーの投稿user_posts | user_idにNSIDを指定して、Flickrメンバーの写真と動画を一覧表示します。タイトル、画像リンク、タグ、撮影日、アップロード日を取得できます。表示名ではなく、検索結果のauthor_idから得たNSIDを指定してください。非公開アルバムは含まれません。 | 1,000リクエストあたり$24 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Flickrの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | media_type, sort | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$24 | 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 | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$24 | id · url · title · image_url · media_type · author_name · author_id · tags · taken_at · posted_at · platform |
Flickrのsearchのパラメータはそれぞれどういう意味ですか？
keywordに一致するFlickrの写真や動画を検索します。タイトル、画像リンク、タグ、撮影者の名前とID、撮影日、アップロード日を取得できます。taken_atはEXIFに基づく値で、空の場合があり、アップロード日時とは異なります。リンクは再利用の権利を付与するものではありません。
keyword必須- searchアクションで写真や動画を検索するための検索語を指定します。返されるメディアの範囲はmedia_typeで指定します。このパラメータで投稿者の表示名を完全一致で検索することはできません。
media_type任意- メディアの範囲で絞り込みます。指定できる値はphotos（写真のみ）、videos（動画のみ）、all（すべてのメディア）です。デフォルトはsearchではphotos、user_postsではallです。このパラメータは検索時の絞り込みを制御するもので、元ファイルをダウンロードするかどうかを決めるものではありません。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のすべての機能をそのまま反映したものではありません。 · 確認日
Flickrのuser_postsのパラメータはそれぞれどういう意味ですか？
user_idにNSIDを指定して、Flickrメンバーの写真と動画を一覧表示します。タイトル、画像リンク、タグ、撮影日、アップロード日を取得できます。表示名ではなく、検索結果のauthor_idから得たNSIDを指定してください。非公開アルバムは含まれません。
user_id必須- 対象のFlickrユーザーのNSID（例：12345678@N04）を指定します。NSIDは検索結果のauthor_idフィールドから取得できます。表示名、プロフィールのカスタムエイリアス、プロフィールURL全体は指定できません。Flickr：ユーザーNSIDの意味 — Flickrのドキュメントでは、`user_id`をユーザーNSIDと定義しており、表示用のスクリーンネームやカスタムプロフィールURLのパスとは異なります。この定義は、EveryInfraがユーザーの非公開写真にアクセスできることを意味しません。 · 確認日
media_type任意- メディアの範囲で絞り込みます。指定できる値はphotos（写真のみ）、videos（動画のみ）、all（すべてのメディア）です。デフォルトはsearchではphotos、user_postsではallです。このパラメータは検索時の絞り込みを制御するもので、元ファイルをダウンロードするかどうかを決めるものではありません。
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_postsでuser_idの互換用エイリアスとして機能します。この場合も、人が読める表示名ではなく有効なFlickrのNSIDが必要です。また、公開のuser_postsリクエストには引き続き必須のuser_idパラメータを含める必要があります。
Flickr APIの使い方
- 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>"}}'
Flickr APIに関する質問
Flickr APIでは何を取得できますか？
platformをflickrに設定します。現在のカタログには検索とユーザーの投稿が掲載されています。これらのアクション名はそれぞれ異なるFlickrのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Flickrのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションで写真や動画を検索するための検索語を指定します。返されるメディアの範囲はmedia_typeで指定します。このパラメータで投稿者の表示名を完全一致で検索することはできません。params内のkeywordとして送信してください。
Flickrのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、image_url、media_type、author_nameが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Flickrのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。