API v1

Credible Public API

Read-only REST endpoints for accessing business profiles, reviews, trust scores, and verification badges. All endpoints return a JSON envelope of the shape { success, data, meta? }.

Authentication

Pass your API key in the X-API-Key header. API keys are issued from the business dashboard and have a default budget of 60 requests / minute.

curl -H "X-API-Key: ck_xxxxxxxxxxxxxxxx" \
  https://credible.com.pl/api/v1/public/business/demo-slug

Endpoints

GET

/public/business/{slugOrId}

Get a business profile by slug or id.

GET

/public/business/{slugOrId}/reviews

List published reviews for a business (paginated).

GET

/public/business/{slugOrId}/trust-score

Compute the 0–100 trust score.

GET

/public/business/{slugOrId}/badge

Get the verification badge metadata.

GET

/public/business/{slugOrId}/widget

Combined payload for the embed widget (profile + reviews + trust).

POST

/public/business/{slugOrId}/widget/event

Track a widget impression (requires `widget.read` scope).

OpenAPI specification

The full machine-readable spec is served at /api/v1/openapi.yaml. Drop it into Stoplight, Redocly, or Swagger UI for an interactive explorer.

Download openapi.yaml