Skip to content

Deletions API

To ensure compliance with privacy regulations, Trustpilot lets consumers delete their consumer profile and any reviews they’ve submitted from the Trustpilot platform.
Each endpoint returns a list of IDs that you should remove from your system as well.

To add pagination to your query, use the following parameters:

limit: Limit the number entries you see per page. The default number of page entries is 100 but you can specify up to 1000.

nextToken: Move to the next page of returned results.



  • Get deleted consumers

    Returns a list of consumer IDs that were deleted within the specified date range. You must delete returned consumer data from your system

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/v1/consumers/deletions

    Parameters

    • limit, Optional integer

      Example: ?limit=50


    • startDate, Optional string

      Example: ?startDate=2025-04-30


    • endDate, Optional string

      Example: ?endDate=2025-05-30


    • nextToken, Optional string

      Example: ?nextToken=eyJsYXN0RXZhbHVhdGVkS2V5Ijp7fX0=


    curl -X GET "https://api.trustpilot.com/v1/consumers/deletions" \
    -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
    "consumers": [
    {
    "consumerId": "5f9c1b9b810c19729de860ea",
    "deletedAt": "2025-04-30T14:32:17.235Z"
    }
    ],
    "nextToken": "eyJsYXN0RXZhbHVhdGVkS2V5Ijp7ImNvbnN1bWVySWQiOiI1ZjljMWI5YjgxMGMxOTcyOWRlODYwZWEifX0="
    }
  • Get deleted reviews

    Returns a list of review IDs that were deleted within the specified date range. You must delete returned review data from your system

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/v1/reviews/deletions

    Parameters

    • limit, Optional integer

      Example: ?limit=50


    • startDate, Optional string

      Example: ?startDate=2025-04-30


    • endDate, Optional string

      Example: ?endDate=2025-05-30


    • nextToken, Optional string

      Example: ?nextToken=eyJsYXN0RXZhbHVhdGVkS2V5Ijp7fX0=


    curl -X GET "https://api.trustpilot.com/v1/reviews/deletions" \
    -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
    "reviews": [
    {
    "reviewId": "6a7b2c3d810c19729de860eb",
    "deletedAt": "2025-04-30T09:45:23.128Z"
    }
    ],
    "nextToken": "eyJsYXN0RXZhbHVhdGVkS2V5Ijp7InJldmlld0lkIjoiNmE3YjJjM2Q4MTBjMTk3MjlkZTg2MGViIn19"
    }
  • Get deleted product reviews

    Returns a list of product review IDs that were deleted within the specified date range. You must delete returned product review data from your system

    HTTP method: GET

    Authentication: API Key

    URL: https://api.trustpilot.com/v1/product-reviews/deletions

    Parameters

    • limit, Optional integer

      Example: ?limit=50


    • startDate, Optional string

      Example: ?startDate=2025-04-30


    • endDate, Optional string

      Example: ?endDate=2025-05-30


    • nextToken, Optional string

      Example: ?nextToken=eyJsYXN0RXZhbHVhdGVkS2V5Ijp7fX0=


    curl -X GET "https://api.trustpilot.com/v1/product-reviews/deletions" \
    -H "apikey: YOUR-API-KEY-HERE"

    Response

    {
    "product-reviews": [
    {
    "productReviewId": "7e3f5d9g810c19729de860ec",
    "deletedAt": "2025-04-30T16:18:45.763Z"
    }
    ],
    "nextToken": "eyJsYXN0RXZhbHVhdGVkS2V5Ijp7InByb2R1Y3RSZXZpZXdJZCI6IjdlM2Y1ZDlnODEwYzE5NzI5ZGU4NjBlYyJ9fQ=="
    }