Website-Scan API

De BSR Website-Scan API is een server-naar-server-endpoint voor integratiepartners. Het analyseert een website en retourneert een deelbare BSR-analyse. Het staat los van de on-page widget — het is bedoeld voor het bouwen van integraties, niet om op een pagina in te sluiten.

Partnerintegratie

Deze API is bedoeld voor backend-integraties en vereist een API-sleutel. Roep hem niet aan vanuit de browser — je sleutel moet server-side blijven.

Endpoint

POST https://bluestars.app/api/integrations/bsr-website-scan
Authorization: Bearer <your-api-key>
Content-Type: application/json

Request body

Veld	Verplicht	Beschrijving
id	Ja	Je referentie/identifier voor deze scan.
email	Ja	Contact-e-mail die bij de scan hoort.
website	Ja	De website-URL die geanalyseerd wordt.
packVersion	Nee	Tegen welk BSR-pack er geanalyseerd wordt.

{
  "id": "your-ref-123",
  "email": "contact@example.com",
  "website": "https://example.com",
  "packVersion": "bsr4"
}

Response

De aanroep is synchroon en kan 1–5 minuten duren (de scan doet echt werk), dus stel een ruime timeout in. Bij succes retourneert hij een deelbare analyse:

• analyseUrl — een link naar de volledige analyse die je kunt delen.
• analyseSummary — een korte samenvatting van het resultaat.

Een sleutel verkrijgen

API-sleutels (bs_live_…) worden per tenant uitgegeven en beheerd onder Instellingen in het dashboard. Neem contact op met Bluestars als je toegang op partnerniveau nodig hebt.