---
title: "Remove many GMV Max video exclusions"
method: POST
path: "/gmv-max/excluded-videos/bulk-remove"
tags: ["GMV Max"]
---

# Remove many GMV Max video exclusions

`POST /gmv-max/excluded-videos/bulk-remove`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/excluded-videos/bulk-remove`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Take a list of videos off this shop's GMV Max exclusion list in one call — the bulk form of DELETE /gmv-max/excluded-videos/{video_id}, with the same effect on each id. Up to 500 valid ids per call; duplicates are collapsed, ids that weren't excluded are counted in `not_excluded`, and inputs that are not a numeric TikTok video id come back in `invalid` (nothing is silently dropped). TikTok does not automatically re-add a creative it has already EXCLUDED, so re-adding one to a campaign is done in Ads Manager. Requires `read_write` scope and an `Idempotency-Key`. Single shop only.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- GmvMaxRemoveExcludedVideosBulkRequest: POST /gmv-max/excluded-videos/bulk-remove request body — take many videos off the exclusion list in one call. Ids the server cannot parse are returned in `invalid`, never silently dropped.
  - `video_ids` string[], required: TikTok video ids to remove from the exclusion list (max 500 per call). Duplicates are collapsed; ids that weren't excluded are counted, not an error.

## Response `200`

Successful Response

- GmvMaxBulkVideoRemovalResponse: POST /gmv-max/excluded-videos/bulk-remove.
  - `data` GmvMaxBulkVideoRemovalResult, required
    - `requested` integer, required: How many ids were sent.
    - `removed` integer, required: Videos taken off the exclusion list.
    - `not_excluded` integer, required: Valid ids that weren't on the exclusion list (nothing to remove).
    - `invalid` string[], required: Inputs that are not a numeric TikTok video id (not removed).
    - `removed_video_ids` string[], required: The ids this call took off the exclusion list.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 100 revisions in range; 1 not diffed.

- **2026-11-13** `3a33c5a3354f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/excluded-videos/bulk-remove/post.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/d8e0ec33c3a5?raw)