chatformdocs
API referenceV1

Search the elements library

GIFs, stickers, memes, illustrations, icons, patterns, music and sound effects, ranked by relevance and popularity. An empty `q` lists the most popular. Place an item by writing its `url` into the form's theme through `PUT /v1/forms/{id}`.

GET
/v1/assets/search

Authorization

AuthorizationBearer <token>

A server-side secret key. Never send one from a browser — a request carrying an Origin header is refused for this reason.

In: header

Query Parameters

q?string
Lengthlength <= 80
kind?string

Value in

  • "gif"
  • "sticker"
  • "meme"
  • "animation"
  • "emoji"
  • "illustration"
  • "graphic"
  • "cutout"
  • "pattern"
  • "texture"
  • "palette"
  • "doodle"
  • "icon"
  • "music"
  • "sfx"
  • "ui_sound"
cursor?string
Lengthlength <= 40
limit?integer
Range1 <= value <= 50
Default20

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/assets/search"
{  "data": [    {      "id": "string",      "kind": "string",      "title": "string",      "tags": [        "string"      ],      "width": 0,      "height": 0,      "duration_ms": 0,      "url": "string"    }  ],  "has_more": true,  "next_cursor": "string"}