API Endpoints

Search a drive

Changed on

Search the drive tied to the personal API token. Matches project names, folder names, layout pack names, media file names, composition text, and transcripts across projects, the drive media library, and Brand Studio. On drives with the Enterprise plan, also allows searches for visual matches. Returns up to 100 results.

get/search

Request

  • Base URL: https://descriptapi.com/v1
  • URL: https://descriptapi.com/v1/search
  • Auth: HTTP bearer

Query parameters

querystring required

Search term. Matched against names, contents, and visual matches (on drives with the Enterprise plan). Must be non-empty.

updated_afterstring date-time

Return results updated at or after this time. Accepts an ISO 8601 date (2026-08-01, interpreted as the start of that UTC day) or timestamp (2026-08-01T09:30:00Z). Values without a timezone offset are read as UTC.

updated_beforestring date-time

Return results updated at or before this time. Accepts an ISO 8601 date (2026-08-01, interpreted as the end of that UTC day) or timestamp (2026-08-01T23:59:59Z). Values without a timezone offset are read as UTC.

ownerstring[]

Return items owned by these user UUIDs. Repeat this parameter to include more than one owner. If omitted, results from all owners are returned.

typestring[]

Result types to search. Repeat this parameter to search more than one type. If omitted, all result types are returned.

  • project: Projects
  • layout_pack: Layout packs
  • project_folder: Folders that hold projects
  • media_library_folder: Folders in the drive media library
  • video, image, audio: Files of that media type in the drive media library, Brand Studio, and inside projects
matchstring[]

How the query may match. Repeat this parameter to allow more than one kind. name matches project, file, folder, and layout pack names. content matches transcripts and composition text. visual matches what appears in videos and images, and is only available on drives with the Enterprise plan. visual cannot be combined with another match kind. If omitted, only names and contents contribute.

sort'relevance' | 'newest' | 'oldest'

How to sort results:

  • relevance: closest matches first. This is the default.
  • newest: most recently modified first.
  • oldest: least recently modified first.
limitinteger

Maximum number of results to return. Defaults to 30. Maximum is 100.

Response

Search completed successfully.

Changes

  • 345f4b8579d3Revision changes
    • info

      added the optional property /// to the response with the status

  • 5f80e2a8eebeRevision changes
    • info

      added the enum value visual to the property items/ of the query request parameter match

    • info

      added the non-success response with the status