Stickers

v1 stable

Search stickers and animated GIFs, with ready-to-use links.

base url https://flye.win/v1/stickers

overview

Find sticker packs by search term and get direct, fast and stable links served by flye.win. A good fit for WhatsApp and Telegram bots, messaging apps and keyboards. Links need no key and can go straight into an img tag.

Authentication, error format, and limits are the same across all APIs. See the general docs.

plans

Free

For testing and personal bots.

quota/month: 500
req/min: 20

500 searches / month
20 searches / minute
Media links don't use quota

Create an account to subscribe

Pro

Black Friday

US$ 2.89 first month

~~US$ 5.29~~ · then US$ 5.29/mo

until Nov 30, 2026

For bots and apps in production.

quota/month: 50,000
req/min: 120

50,000 searches / month
120 searches / minute
30-day logs

Create an account to subscribe

Card

Scale

Black Friday

US$ 91.29 first month

~~US$ 146.19~~ · then US$ 146.19/mo

until Nov 30, 2026

For companies with many users: the limit is per end user, not per account.

quota/month: unlimited
req/min: 300 per user

Unlimited searches, no monthly cap
300 searches / minute for each end user
One user at the limit doesn't affect the others
3,000 / minute for calls without an id
Priority support

Create an account to subscribe

Card

Your key to test here Get a key

Use a test key (flye_test_…): it answers with the examples, without using quota or needing a plan. The key stays in this browser tab only and is never sent to our site.

GET /v1/stickers/search — Search stickers

Returns the most relevant pack for the term, with a link for each sticker. With rotate=true, each call returns the next pack, so bots don't repeat the same result. A term never searched before may come right away with partial=true, with what we already have, while the full search finishes.

parameter	in	type	description
q	query	string	Search term, 2 to 80 characters. Without it, the response has 30 featured stickers, drawn on every call, with trending=true.
X-End-User-Id	header	string	Scale plan: identifies the user on your platform, so the limit applies per user and not to the account. Use a stable id, preferably a hash.
max_wait_ms	query	integer	Longest wait for a term never searched before, 0 to 15000 ms. Past that, the response returns right away with pending=true and the search continues: repeat the call shortly. Without it, waits for the result.
limit	query	integer	Stickers per response, 1 to 30. Defaults to 30.
type	query	string	all, animated or static. Defaults to all.
page	query	integer	Pack position in the ranking, starting at 1. Defaults to 1.
rotate	query	boolean	true returns the next pack on each call from this account. Ignores page.

curl "https://flye.win/v1/stickers/search?q=gato&max_wait_ms=300&limit=10" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/stickers/search?q=gato&max_wait_ms=300&limit=10", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/stickers/search?q=gato&max_wait_ms=300&limit=10",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/stickers/search?q=gato&max_wait_ms=300&limit=10", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/stickers/search?q=gato&max_wait_ms=300&limit=10');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

response · 200

{
  "query": "gato",
  "total_packs": 12,
  "pack": {
    "id": "pk_3f9a1c7e2b8d4a60c1e5",
    "name": "Gatos engraçados",
    "author": "Ana",
    "animated": true,
    "count": 30
  },
  "stickers": [
    {
      "id": "8e1f0c3ab94d27f6a5c1e08d7b3f4a12",
      "url": "https://flye.win/media/stickers/8e1f0c3ab94d27f6a5c1e08d7b3f4a12.webp",
      "format": "webp",
      "animated": true
    }
  ]
}

Try it now

q · query X-End-User-Id · header max_wait_ms · query limit · query type · query page · query rotate · query

The call goes from your browser straight to the API.

GET /v1/stickers/packs — List packs

Lists the packs found for the term, with a cover sticker, so you can build a picker.

parameter	in	type	description
q*	query	string	Search term, 2 to 80 characters.
X-End-User-Id	header	string	Scale plan: identifies the user on your platform, so the limit applies per user and not to the account. Use a stable id, preferably a hash.
max_wait_ms	query	integer	Longest wait for a term never searched before, 0 to 15000 ms. Past that, the response returns right away with pending=true and the search continues: repeat the call shortly. Without it, waits for the result.
limit	query	integer	Packs per page, 1 to 20. Defaults to 10.
page	query	integer	Page, starting at 1.
type	query	string	all, animated or static. Defaults to all.

curl "https://flye.win/v1/stickers/packs?q=gato&max_wait_ms=300&limit=5" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/stickers/packs?q=gato&max_wait_ms=300&limit=5", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/stickers/packs?q=gato&max_wait_ms=300&limit=5",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/stickers/packs?q=gato&max_wait_ms=300&limit=5", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/stickers/packs?q=gato&max_wait_ms=300&limit=5');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

response · 200

{
  "query": "gato",
  "total": 12,
  "page": 1,
  "packs": [
    {
      "id": "pk_3f9a1c7e2b8d4a60c1e5",
      "name": "Gatos engraçados",
      "author": "Ana",
      "animated": true,
      "count": 30,
      "cover": "https://flye.win/media/stickers/8e1f0c3ab94d27f6a5c1e08d7b3f4a12.webp"
    }
  ]
}

Try it now

q * · query X-End-User-Id · header max_wait_ms · query limit · query page · query type · query

The call goes from your browser straight to the API.

GET /v1/stickers/packs/{id} — Stickers in a pack

Returns every sticker in a pack by its id.

parameter	in	type	description
id*	path	string	Pack id, from /search or /packs.

curl "https://flye.win/v1/stickers/packs/{id}" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/stickers/packs/{id}", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/stickers/packs/{id}",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/stickers/packs/{id}", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/stickers/packs/{id}');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

response · 200

{
  "pack": {
    "id": "pk_3f9a1c7e2b8d4a60c1e5",
    "name": "Gatos engraçados",
    "author": "Ana",
    "animated": true,
    "count": 30
  },
  "stickers": [
    {
      "id": "8e1f0c3ab94d27f6a5c1e08d7b3f4a12",
      "url": "https://flye.win/media/stickers/8e1f0c3ab94d27f6a5c1e08d7b3f4a12.webp",
      "format": "webp",
      "animated": true
    }
  ]
}

Try it now