Parámetros de búsqueda disponibles

El endpoint /resources acepta varios parámetros para refinar tus resultados de búsqueda.

Búsqueda básica

POST https://api.cathopic.com/resources
{
  "query": "San Francisco",
  "page": 1,
  "page_size": 20,
  "order": "popular"
}

Parámetros

query (string, opcional)

Tu término de búsqueda. Déjalo vacío para obtener todos los recursos.

• Ejemplos: "Virgen María", "Eucaristía", "cruz"

• Soporta coincidencia difusa y tolerancia a errores tipográficos

• Busca en títulos, descripciones y etiquetas

page (integer, por defecto: 1)

Qué página de resultados devolver. Comienza en 1.

page_size (integer, por defecto: 20, máx: 100)

Número de resultados por página. El máximo es 100 para mantener el rendimiento.

order (string, por defecto: "popular")

Cómo ordenar los resultados:

• popular - Recursos más descargados primero

• recent - Subidas más recientes primero

Estructura de respuesta

{
  "total": 1523,
  "page": 1,
  "page_size": 20,
  "results": [
    {
      "id": 1234,
      "name": "Título del recurso",
      "description": "Descripción del recurso",
      "type": "photo",
      "orientation": "portrait",
      "thumbnail_url": "https://...",
      "author": { ... },
      "tags": ["etiqueta1", "etiqueta2"]
    }
  ]
}

Ejemplos prácticos

Obtener los 10 recursos más populares sobre oración:

{
  "query": "oración",
  "page": 1,
  "page_size": 10,
  "order": "popular"
}

Obtener subidas recientes, sin término de búsqueda específico:

{
  "query": "",
  "page": 1,
  "page_size": 50,
  "order": "recent"
}

Navegar página 3 de imágenes de santos:

{
  "query": "santos",
  "page": 3,
  "page_size": 20,
  "order": "popular"
}

Para la referencia completa de la API, visita api.cathopic.com/docs.