Stickers

v1 stable

Busca de figurinhas e GIFs animados, com links prontos para usar.

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

visão geral

Encontre packs de figurinhas por termo e receba links diretos, rápidos e estáveis, servidos pela flye.win. Boa para bots de WhatsApp e Telegram, apps de mensagem e teclados. Os links não pedem chave e podem ser colocados direto em uma tag img.

Autenticação, formato de erro e limites são iguais em todas as APIs — veja a documentação geral.

planos

Free

Grátis

Para testar e bots pessoais.

quota/mês: 500
req/min: 20

500 buscas / mês
20 buscas / minuto
Links de mídia sem limite de quota

Criar conta para assinar

Pro

Black Friday

US$ 2,89 no 1º mês

~~US$ 5,29~~ · depois US$ 5,29/mês

até 30 nov 2026

Para bots e apps em produção.

quota/mês: 50.000
req/min: 120

50.000 buscas / mês
120 buscas / minuto
Logs de 30 dias

Criar conta para assinar

Cartão

Scale

Black Friday

US$ 91,29 no 1º mês

~~US$ 146,19~~ · depois US$ 146,19/mês

até 30 nov 2026

Para empresas com muitos usuários: o limite é por usuário final, não da conta.

quota/mês: ilimitado
req/min: 300 por usuário

Buscas ilimitadas, sem teto mensal
300 buscas / minuto para cada usuário final
Um usuário no limite não afeta os outros
3.000 / minuto em chamadas sem identificação
Suporte prioritário

Criar conta para assinar

Cartão

Sua chave para testar aqui Pegar uma chave

Use uma chave de teste (flye_test_…): ela responde com os exemplos, sem gastar cota e sem precisar de plano. A chave fica só nesta aba do navegador e não é enviada ao nosso site.

GET /v1/stickers/search — Buscar figurinhas

Devolve o pack mais relevante para o termo, com os links de cada figurinha. Com rotate=true, cada chamada entrega o próximo pack, ideal para bots não repetirem o mesmo resultado. Um termo nunca buscado pode vir na hora com partial=true, com o que já temos, enquanto a busca completa termina.

parâmetro	onde	tipo	descrição
q	query	string	Termo de busca, de 2 a 80 caracteres. Sem ele, a resposta traz 30 figurinhas em destaque, sorteadas a cada chamada, com trending=true.
X-End-User-Id	header	string	Plano Scale: identifica o usuário da sua plataforma, para o limite valer por usuário e não para a conta. Use um id estável, de preferência um hash.
max_wait_ms	query	integer	Tempo máximo de espera por um termo nunca buscado, de 0 a 15000 ms. Passando disso, a resposta volta na hora com pending=true e a busca continua: repita a chamada em instantes. Sem o parâmetro, espera o resultado.
limit	query	integer	Figurinhas por resposta, de 1 a 30. Padrão 30.
type	query	string	all, animated ou static. Padrão all.
page	query	integer	Posição do pack no ranking, a partir de 1. Padrão 1.
rotate	query	boolean	true entrega o próximo pack a cada chamada desta conta. Ignora 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);

resposta · 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
    }
  ]
}

Testar agora

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

A chamada sai do seu navegador, direto para a API.

GET /v1/stickers/packs — Listar packs

Lista os packs encontrados para o termo, com uma figurinha de capa, para você montar uma tela de escolha.

parâmetro	onde	tipo	descrição
q*	query	string	Termo de busca, de 2 a 80 caracteres.
X-End-User-Id	header	string	Plano Scale: identifica o usuário da sua plataforma, para o limite valer por usuário e não para a conta. Use um id estável, de preferência um hash.
max_wait_ms	query	integer	Tempo máximo de espera por um termo nunca buscado, de 0 a 15000 ms. Passando disso, a resposta volta na hora com pending=true e a busca continua: repita a chamada em instantes. Sem o parâmetro, espera o resultado.
limit	query	integer	Packs por página, de 1 a 20. Padrão 10.
page	query	integer	Página, a partir de 1.
type	query	string	all, animated ou static. Padrão 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);

resposta · 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"
    }
  ]
}

Testar agora

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

A chamada sai do seu navegador, direto para a API.

GET /v1/stickers/packs/{id} — Figurinhas de um pack

Devolve todas as figurinhas de um pack pelo id.

parâmetro	onde	tipo	descrição
id*	path	string	Id do pack, vindo de /search ou /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);

resposta · 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
    }
  ]
}

Testar agora