Search across all brand asset types (images, colors, fonts, videos) in your workspace
This endpoint allows you to search across all brand asset types in your workspace — images, colors, fonts, and videos — in a single request. You can filter by keyword (matching against names, tags, font families, and color values) and optionally restrict to specific asset types. When no query is provided, it lists all assets of the requested type(s).
https://api.orshot.com/v1/brand-assets/searchParameter Type Required Description queryString No Search keyword. Matches against file names, font families, color values, video names, and tags (case-insensitive). Omit to list all assets. typesString No Comma-separated asset types to search: image, color, font, video. Defaults to all types if omitted. pageNumber No Page number for pagination (starts at 1). Defaults to 1. limitNumber No Number of results per type per page (1–50). Defaults to 10.
Search All Search by Type List All Fonts Response
await fetch("https://api.orshot.com/v1/brand-assets/search?query=logo", {
method: "GET",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
});
30 requests per minute per endpoint
The response contains only the requested types, ordered by most recently created. Each type includes a data array and a total count for pagination. Top-level page and limit fields reflect the current pagination state.
Field Type Description idNumber Unique identifier for the image nameString Original filename urlString Direct URL to the image tagsString[] Tags associated with the image typeString Always "image"
Field Type Description idNumber Unique identifier for the color colorTypeString Color format: hex, rgb, hsl, or gradient valueString Color value (e.g. "#FF5733") tagsString[] Tags associated with the color typeString Always "color"
Field Type Description idNumber Unique identifier for the font nameString Display name of the font fontFamilyString CSS font-family name urlString Direct URL to the font file tagsString[] Tags associated with the font typeString Always "font"
Field Type Description idNumber Unique identifier for the video nameString Video name urlString Direct URL to the video thumbnailUrlString URL to the video thumbnail durationNumber Video duration in seconds tagsString[] Tags associated with the video typeString Always "video"
