ReviewLab API Integration

API Capabilities

Using the ReviewLab API, you can:

• Retrieve widget data
• Retrieve the list of reviews from a specific widget

Getting Started

To start working with the ReviewLab API:

1. Sign up in the dashboard
2. Create a widget and add links to the branch locations from which reviews should be collected

Retrieving Widget Data

Request Format

GET https://app.reviewlab.pro/api/v1/widgets/widget/:widgetId/reviews/remote

Where widgetId is the widget identifier, which is available in the browser address bar on the widget page.

The request returns a list of widget reviews with pagination and filtering support.

Request Parameters

Path parameters:

Query parameters:

Request Examples

# First 20 reviews
GET /api/v1/widgets/widget/abc123/reviews/remote?limit=20

# Second page (reviews 20-40)
GET /api/v1/widgets/widget/abc123/reviews/remote?skip=20&limit=20

# Only reviews from Avito
GET /api/v1/widgets/widget/abc123/reviews/remote?limit=20&type=avito

Response Format

[
  {
    "_id": "string",
    "name": "string",
    "photo": "string",
    "message": "string",
    "images": ["string"],
    "rating": "number",
    "date": "Date",
    "src": "string",
    "type": "string"  // "doubleGis" | "yaSprav" | "avito" | "zoon" | "vkontakte" | "prodoctorov" | "otzovik" | "googleMap" | "yaBusiness"
  }
]

Pagination

To load data page by page, use a combination of the skip and limit parameters:

// Page 1
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=0')

// Page 2
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=20')

// Page 3
fetch('/api/v1/widgets/widget/abc123/reviews/remote?limit=20&skip=40')

Rate Limits

• Maximum of 300 reviews per single request
• If the limit is exceeded, the API will return 400 Bad Request