Search swipe files
Filtered vector search. The text query is embedded and cosine-matched against swipe file image embeddings, optionally filtered by industry, ad_format, aspect_ratio, and awareness_stage. Only ready swipe files are returned. This is a read operation and requires the swipe_files:read scope.
API key for authentication. Include in the X-API-Key header.
In: header
Natural-language query. Embedded and cosine-matched against swipe file image embeddings.
1 <= lengthRestrict results to one or more industries. Pass a string or an array of strings; multiple values match any.
Restrict results to one or more ad formats. Pass a string or an array of strings; multiple values match any.
Restrict results to one or more aspect ratios. Pass a string or an array of strings; multiple values match any.
Restrict results to one or more stages of awareness. Matches the primary OR the secondary label, and results are ordered with primary matches first. Pass a string or an array of strings; multiple values match any.
Restrict managed results to these subscribed data sources. Omit for all subscribed sources; pass an empty array to exclude managed designs entirely.
Whether to include your organization's own uploads. Defaults to true.
Search only the designs in this design pack, e.g. to pick the closest matches from a pack.
Maximum number of results to return (1-100, default 20).
201 <= value <= 100Response Body
curl -X POST "https://api.staticadslab.com/v1/swipe-files/search" \
-H "Content-Type: application/json" \
-d '{
"query": "minimalist beige flatlay"
}'{
"data": [
{
"id": "sf_a1b2c3d4e5f67890",
"image_url": "https://cdn.staticadslab.com/swipe-files/sf_abc.png",
"thumbnail_small_src": "string",
"thumbnail_medium_src": "string",
"thumbnail_large_src": "string",
"width": 1080,
"height": 1080,
"aspect_ratio": "1:1",
"industry": "Apparel & Accessories",
"ad_format": "Sale",
"awareness_stage": "Solution Aware",
"awareness_stage_secondary": "Most Aware",
"awareness_confidence": "high",
"source": "upload",
"is_managed": false,
"status": "ready",
"error": "string",
"created_at": "2026-07-03T12:00:00.000Z",
"updated_at": "2026-07-03T12:00:00.000Z",
"similarity": 0.82
}
],
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "string",
"message": "string"
}
]
},
"meta": {
"request_id": "req_a1b2c3d4e5f67890",
"timestamp": "2026-03-27T12:00:00.000Z"
}
}