Use GET /api/v2/catalog com catalog.read. Ele usa a camada de busca fuzzy tolerante a erros de digitação já existente do Cathopic e carrega os mesmos modelos canônicos de mídia usados pela grade do site.
Parâmetros
qouquery: texto com até 250 caracteres.type: photo, video, graphic, artwork, ai, ou all.orientation: landscape, portrait, square, ou all.sort: most_recent, popular, ou popular_alltime.page,per_page: até 50, elocale.
GET /api/v2/catalog?q=adoration&type=photo&orientation=landscape&per_page=30
Authorization: Bearer ACCESS_TOKENUse URLs de pré-visualização sem alterações
Cada resultado inclui preview.url e preview.transformation_url_template. Eles vêm do mesmo apresentador de grade, host do CDN, caminho de armazenamento e regras de marca d’água usados em cathopic.com. Use-os sem alterações para que integrações reutilizem as chaves de cache existentes do Cloudflare.
Não envie outra cópia nem faça proxy desnecessariamente.
Não adicione parâmetros de consulta para quebrar cache.
Substitua
<OPTIONS>apenas por opções de imagem estáveis do Cloudflare.
As pré-visualizações nunca consomem um download. already_licensed inclui permissões individuais e da equipe compartilhada.
