プロジェクトを検索する Tier 3

GET/api/projects.searchCopied!

バインドされたワークスペース内で、API キーから参照可能なプロジェクトを返します。

リクエスト

クエリ

querystringrequired

1〜255 文字

検索テキスト

pagenumber

1〜100

ページ番号

Default: 1

sort.typestring

ソートフィールド

Possible values: namecreatedAt

Default: createdAt

sort.directionstring

ソート方向

Possible values: ascdesc

Default: desc

レスポンス

200 OK を返します。

dataarray

プロジェクト一覧

data[].idstring

プロジェクト ID

Example: bdbff5de-96d7-468f-9db0-85fe28bd6b62

data[].namestring

プロジェクト名

Example: Launch Campaign

data[].descriptionstring?

プロジェクトの説明

Example: Social assets for Q4 launch

data[].thumbnailstring?

サムネイル URL

Example: https://cdn.youvico.com/projects/launch.png

data[].createdAtstring

プロジェクト作成日時

Example: 2026-04-10 05:11:44.000000

data[].updatedAtstring

プロジェクト最終更新日時

Example: 2026-04-10 08:20:00.000000

pageobject

ページネーション

page.currentnumber

現在のページ番号

Example: 1

page.hasNextboolean

次のページが存在するか

Example: false

例

curl 'https://api.youvico.com/api/projects.search?query=launch&sort.type=createdAt&sort.direction=desc' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign",
      "description": "Social assets for Q4 launch",
      "thumbnail": "https://cdn.youvico.com/projects/launch.png",
      "createdAt": "2026-04-10 05:11:44.000000",
      "updatedAt": "2026-04-10 08:20:00.000000"
    }
  ],
  "page": {
    "current": 1,
    "hasNext": false
  }
}

TIP

このルートはスラッシュ（projects/search）ではなく、ドット区切り（projects.search）の名称を使用します。