Cómo buscar en el catálogo y usar las URLs de preview de Cathopic

Usa GET /api/v2/catalog con catalog.read. Utiliza la capa existente de búsqueda fuzzy tolerante a errores y los mismos modelos canónicos del grid de la web.

Parámetros

• q o query: texto de hasta 250 caracteres.

• type: photo, video, graphic, artwork, ai o all.

• orientation: landscape, portrait, square o all.

• sort: most_recent, popular o popular_alltime.

• page, per_page hasta 50 y locale.

GET /api/v2/catalog?q=adoracion&type=photo&orientation=landscape&per_page=30
Authorization: Bearer ACCESS_TOKEN

Usar las URLs sin modificar

Cada resultado incluye preview.url y preview.transformation_url_template. Proceden exactamente del mismo presenter, host CDN, ruta y reglas de marca de agua del grid de cathopic.com. Úsalas sin cambios para reutilizar las claves de caché existentes de Cloudflare.

• No subas otra copia ni la pases por un proxy innecesario.

• No añadas parámetros para invalidar la caché.

• Sustituye <OPTIONS> solo por opciones estables de Cloudflare.

Las previews nunca consumen descargas. already_licensed incluye derechos individuales y de equipo.