Sign in
freepikAssets

Search

Search backgrounds by what is IN the image, not by which template wants it.

A template is a combination of these filters, so supporting a new layout costs a new query string and no schema change:

design_11 — opaque copy card, BLACK logo top-left /search?text_safe_black=top-left&tags=style:ugc

design_07 — 78px WHITE type on the photo, white logo top-right, subject low /search?text_safe_white=top-left&text_safe_white=top-right &subject_top_min=0.24&tags=style:ugc

get/api/v1/freepik-assets/search

Query parameters

subject_zonestring[] nullable

Repeat to accept several: &subject_zone=top-right&subject_zone=center

Repeat to accept several: &subject_zone=top-right&subject_zone=center

subject_top_minnumber nullable

Subject starts at or below this depth — keeps the top clear for a headline

Subject starts at or below this depth — keeps the top clear for a headline

subject_top_maxnumber nullable
subject_left_minnumber nullable
subject_right_minnumber nullable
text_safe_whitestring[] nullable

ALL listed zones must be safe for white type

ALL listed zones must be safe for white type

text_safe_blackstring[] nullable

ALL listed zones must be safe for black type

ALL listed zones must be safe for black type

keywordsstring[] nullable

ALL must be present

ALL must be present

keywords_anystring[] nullable

ANY may match

ANY may match

qstring nullable

Free text over the generated description

Free text over the generated description

has_textboolean nullable
tagsstring[] nullable

e.g. tags=style:ugc

e.g. tags=style:ugc

orientationstring nullable
licensedboolean nullable
statusstring nullable
min_widthinteger nullable
measured_onlyboolean
include_descriptorboolean

Adds ~9KB per row

Adds ~9KB per row

order_bystring
limitinteger
offsetinteger

Response

Successful Response

totalinteger required

Matches before limit/offset

returnedinteger required

Changes

No recorded changes to this endpoint across all 1 revision of this API.