Connect API (1.1)

Partner Connect API Service

Download OpenAPI description
open-api.json
open-api.yaml
Languages
Servers
Production URL
https://metasearch-connect-api.booking.com/

reports

Operations

List conversions

Request

This endpoint returns conversion data for bookings within a specified date range.

Note: Conversions data is only provided for selected accounts based on contractual agreements.

The booking_date_range parameter is required and must include both from and to dates in ISO-8601 format (YYYY-MM-DD). Results are paginated with a default page size of 100 and a maximum of 1000 records per page. Use the page_token from the response to retrieve subsequent pages.

Example request:

{
  "booking_date_range": {
    "from": "2025-01-01",
    "to": "2025-01-31"
  },
  "page_size": 100
}
Bodyapplication/jsonrequired
booking_date_rangeobject(DateRange)required

Date range for filtering conversions by booking date.

booking_date_range.​fromstring(date)required

Start date of the range in ISO-8601 format (YYYY-MM-DD).

Example: "2025-01-01"
booking_date_range.​tostring(date)required

End date of the range in ISO-8601 format (YYYY-MM-DD). Must be equal to or after the 'from' date.

Example: "2025-01-31"
page_sizeinteger(int32)[ 1 .. 1000 ]

Number of results per page. Default is 100, maximum is 1000.

Default 100
Example: 100
page_tokenstring

Token for retrieving the next page of results. Obtained from the previous response's pagination.next_page_token.

Example: ""
curl -i -X POST \
  https://metasearch-connect-api.booking.com/reports/conversions \
  -H 'Authorization: Bearer <YOUR_string_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "booking_date_range": {
      "from": "2025-01-01",
      "to": "2025-01-31"
    },
    "page_size": 100,
    "page_token": ""
  }'

Responses

OK

Bodyapplication/json
conversionsArray of objects(Conversion)

List of conversion records matching the search criteria.

paginationobject(ConversionsPagination)

Pagination information for the conversions response.

metadataobject(ConversionsMetadata)

Metadata about the conversions response.

Response
application/json
{
  "conversions": [
    { … }
  ],
  "pagination": {
    "next_page_token": "eyJwYWdlIjogMn0=",
    "total_results": 150,
    "total_pages": 2,
    "random_page_access": false
  },
  "metadata": {
    "request_id": "req_abc123xyz",
    "timestamp": "2025-01-19T10:30:00Z",
    "result_count": 50
  }
}

demand-api-v3-compatible

Operations

demand-api-v2-compatible

Operations