---
title: "チェックインの検索"
method: GET
path: "/v1/search/checkins"
tags: ["search"]
---

# チェックインの検索

`GET /v1/search/checkins`

指定した条件でチェックインを検索します。すべての公開チェックインとログインユーザーの全チェックインが対象となります。

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

* ユーザー名 (完全一致)
  * `user:ユーザー名`
* チェックイン日付
  * 完全一致: `date:2020-07-21`
  * 指定日以前: `until:2020-07-21`
  * 指定日以降: `since:2020-07-21`
* オカズリンク
  * 部分一致: `url:URL` または `link:URL`
  * 何でもいいからリンクが書かれている: `has:url` または `has:link`
* タグ
  * 完全一致: `tag:タグ名`
  * 部分一致: `タグ名` (頭にtag:を付けない、今まで通りの書き方)
* ノート
  * 部分一致: `note:ノートの内容`
  * 何でもいいからノートが書かれている: `has:note`
* 「より過激なオカズ」チェックの有無
  * `is:sensitive`

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

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

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

## Query parameters

- `q` string, required
- `page` integer
- `per_page` integer

## Response `200`

成功

- Checkin[]
  - `id` integer — チェックインID
  - `checked_in_at` string, date-time — チェックイン日時
  - `tags` string[] — タグ
  - `link` string — オカズリンク (http, https)
  - `note` string — ノート
  - `is_private` boolean — 非公開チェックインとして設定
  - `is_too_sensitive` boolean — チェックイン対象のオカズをより過激なオカズとして設定
  - `discard_elapsed_time` boolean — 前回チェックインからの経過時間を記録しない
  - `source` 'web' | 'csv' | 'webhook' | 'api' — チェックインの登録元
  - `user` User — ユーザーデータ
    - `name` string, required — ユーザー名 (多くの画面では先頭に @ を付けて表示されますが、ここでは含まれません)
    - `display_name` string, required — 名前
    - `is_protected` boolean, required — チェックイン履歴の非公開フラグ
    - `private_likes` boolean, required — いいね一覧の非公開フラグ
    - `bio` string — 自己紹介文
    - `url` string, uri — プロフィール上に掲載するURL
    - `checkin_summary` CheckinSummary — チェックインの概況
      - `current_session_elapsed` integer, required — 最後のチェックインからの経過秒数 (現在のセッション)
      - `total_checkins` integer, required — 合計チェックイン回数
      - `total_times` integer, required — 合計時間 (秒)
      - `average_interval` integer, required — チェックイン間隔の平均値 (秒)
      - `median_interval` integer, required — チェックイン間隔の中央値 (秒)
      - `longest_interval` integer, required — チェックイン間隔の最大値 (秒)
      - `shortest_interval` integer, required — チェックイン間隔の最小値 (秒)

## Changes

- **2025-10-04** `b4d0c5ec1b22` — 1 info
  - endpoint added
- **2020-07-21** `be57ea2beb88` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/shikorism/apis/tissue-api/changes/v1/search/checkins/get.md)

---

[API](https://skmtc.dev/shikorism/apis/tissue-api.md) · [All operations](https://skmtc.dev/shikorism/apis/tissue-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shikorism/tissue-api/revisions/ba4127ea2b1b/schema)