v31

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01251650.0 KB
search

コレクションの検索

指定した条件でコレクション内に登録されたオカズを検索します。すべての公開コレクションとログインユーザーの全コレクションが対象となります。

検索クエリについて

検索キーワードには、詳細条件として以下のクエリを指定することができます。

  • ユーザー名 (完全一致)
    • user:ユーザー名
  • オカズリンク
    • 部分一致: url:URL または link:URL
  • タグ
    • 完全一致: tag:タグ名
    • 部分一致: タグ名 (頭にtag:を付けない、今まで通りの書き方)
  • ノート
    • 部分一致: note:ノートの内容
    • 何でもいいからノートが書かれている: has:note

複数の条件で検索したい場合 (AND検索) 、スペースで区切って入力してください。
なお、OR検索には対応していません。

ノートの検索条件に半角スペースを含めたい場合、条件区切りにならないようダブルクォーテーションで囲ってください。
例) note:"で か い ち ち"

すべての条件はマイナス検索をサポートしています。条件の先頭にマイナス符号を付けてください。
例) 3次元以外を検索する: -tag:3次元

get/v1/search/collections

Query parameters

qstring required

検索キーワード (クエリ)

pageinteger

ページ番号

per_pageinteger

1ページあたりのアイテム数

Response

成功

idinteger required

コレクションアイテムID

collection_idinteger required

コレクションID

linkstring required

オカズリンク (http, https)

notestring

ノート

tagsstring[]

タグ

Example response

[
  {
    "link": "http://example.com",
    "note": "すごく抜ける",
    "tags": [
      "Example",
      "Example_2"
    ]
  }
]