API publique

Intégrez IMAG'IN dans vos applications

Recherche d'images

Récupérez des images publiées avec filtres par catégorie et mot-clé.

GET /api/public/images
?q=nature
&category=paysage
&page=1
&limit=20

Paramètres

  • q — Recherche par mot-clé
  • category — Filtre par catégorie
  • page — Numéro de page (défaut: 1)
  • limit — Résultats par page (max: 50)

Exemple de réponse

{
  "success": true,
  "data": [
    {
      "id": "abc123",
      "title": "Coucher de soleil",
      "description": "Magnifique coucher de soleil sur la plage",
      "thumbnailUrl": "https://...",
      "price": 5000,
      "licenseType": "standard",
      "resolution": "4K",
      "tags": "soleil, plage, nature",
      "category": "nature",
      "photographer": {
        "id": "user1",
        "firstName": "Jean",
        "lastName": "Dupont"
      },
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

Licence d'utilisation

Les images récupérées via l'API sont soumises aux mêmes licences que sur la plateforme. Veuillez respecter les termes de chaque licence.