# Abrufen von Bildinformationen

#### Beschreibung

Diese Schnittstelle liefert Ihnen Informationen zu Stock-Photos. Zurückgegeben werden die Bildnummer, der Bildtitel und der Urheber des Fotos.

**Unterstützt werden aktuell die folgenden Bildagenturen:**

- AdobeStock
- iStockPhoto
- Pixabay

<p class="callout warning">Hinweis: Seit Oktober 2025 wird **ClipDealer** nicht mehr unterstützt.</p>

#### Einsatzzweck

Diese API kann Sie dabei unterstützen die notwendigen Angaben zu erworbenen Bildlizenzen automatisch zu erstellen.

#### Voraussetzungen/Einschränkungen

Diese API kann nur von unseren Kunden mit einem gültigen **Content- und Wartungsvertrag** verwendet werden.  
Der Zugriff ist nur von authorisierten Domains zugelassen.

#### Aufruf

<table border="1" id="bkmrk-api-name-loading-scr" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>**API Name**  
</td><td>license  
</td></tr><tr><td>**API Type** </td><td>*Name der Bildagentur*  
</td></tr></tbody></table>

#### Eingabeparameter

<table border="1" id="bkmrk-parameter-format-pfl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 26.4519%;"></col><col style="width: 16.0689%;"></col><col style="width: 8.043%;"></col><col style="width: 49.5578%;"></col></colgroup><tbody><tr><td>**Parameter**  
</td><td>**Format** </td><td>**Pflicht**  
</td><td>**Erläuterung**  
</td></tr><tr><td>makler  
</td><td>Integer  
</td><td>Ja  
</td><td>Ihre Makler-ID bei versicherungsmarkt.de  
</td></tr><tr><td>filenumber  
</td><td>String  
</td><td>Ja  
</td><td>Die Bildnummer, die Sie abfragen möchten  
</td></tr></tbody></table>

#### Ausgabeparameter

<table border="1" id="bkmrk-parameter-format-fal" style="border-collapse: collapse; width: 100%; height: 522.6px;"><colgroup><col style="width: 32.3857%;"></col><col style="width: 19.9011%;"></col><col style="width: 47.7132%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Parameter**  
</td><td style="height: 29.8px;">**Format** </td><td style="height: 29.8px;">**Erläuterung**  
</td></tr><tr style="height: 29.8px;"><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="135">date

</td><td style="height: 29.8px;">Timestamp  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt; height: 29.8px;" valign="top" width="287">Datum, wann diese Bildnummer erstmals über die API erfragt wurde

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">filenumber

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Bildnummer

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">dealer

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Bildagentur

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">title

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Name des Fotos

</td></tr><tr><td style="width: 101.4pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">creator

</td><td>Text  
</td><td style="width: 215.35pt; border: 1pt solid windowtext; padding: 0cm 5.4pt;">Name des Urhebers

</td></tr></tbody></table>

#### Beispiel-Aufruf

<p class="callout info">https://api.versicherungsmarkt.de/license/AdobeStock?filenumber=670402021</p>

#### Beispiel-Antwort

```json
{
  "success": true,
  "data": {
    "date": "2024-11-19 10:05:00",
    "bildnr": "670402021",
    "dealer": "AdobeStock",
    "title": "Newspaper Advertising Banner on Magazine, Brochure Mockup 3D Rendering",
    "creator": "Khaled"
  }
}
```