プロジェクト検索 Tier 3

GET/api/projects.searchCopied!

APIキーに紐づくワークスペース内でアクセス可能なプロジェクトを返します。

リクエスト

クエリ

querystringrequired

1–255 characters

検索テキスト

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）を使用します。