RevContent Widget Optimizer API
Campaign-level widget blacklisting.
Campaign-level widget blacklisting.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/revcontent-widget-optimizer-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: RevContent Widget Optimizer API
description: Campaign-level widget blacklisting (widget optimizer).
version: '1.0'
contact:
name: RevContent Support
url: https://www.revcontent.com/resources/contact-us
email: developer@revcontent.com
servers:
- url: https://api.revcontent.io
description: RevContent Production API
security:
- BearerAuth: []
tags:
- name: Widget Optimizer
description: Campaign-level widget blacklisting (widget optimizer).
paths:
/stats/api/v1.0/boosts/{boost_id}/targets/blacklist/widgets:
get:
operationId: getTargetsOptimizerWidgets
summary: Get list of blacklisted widget ids
description: Get list of widget ids that are blacklisted
tags:
- Widget Optimizer
x-permission:
- Advertiser
parameters:
- name: boost_id
in: path
required: true
description: Campaign ID.
schema:
type: number
- name: sub_account_id
in: query
required: false
description: Sub Account ID. By default all actions are for your user account if sub account ID is not specified.
schema:
type: number
responses:
'200':
description: Successful response.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: array
items:
type: object
description: Widget id
required:
- id
description: List of widget ids
required:
- data
example:
data:
- id: '100'
- id: '123'
'401':
description: Missing or invalid access token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Error 500
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
errors:
- code: 500
title: There was a problem serving the requested information. Try again, the problem may be temporary. Please contact support if the problem persists.
x-codeSamples:
- lang: json
label: Get targets optimizer widgets
source: "curl -X POST \\\n -H \"Authorization: Bearer e62a04f681ba57d0120f8f584b688e31f04cf41d\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Cache-Control: no-cache\" \\\n 'https://api.revcontent.io/stats/api/v1.0/boosts/308/targets/blacklist/widgets'"
/stats/api/v1.0/boosts/{boost_id}/targets/blacklist/widgets/add:
post:
operationId: postTargetsWidgetsOptimizerAdd
summary: Add Blacklist Widget
description: Add widget id to widget blacklists.
tags:
- Widget Optimizer
x-permission:
- Advertiser
parameters:
- name: boost_id
in: path
required: true
description: Campaign ID.
schema:
type: number
- name: sub_account_id
in: query
required: false
description: Sub Account ID. By default all actions are for your user account if sub account ID is not specified.
schema:
type: number
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Widget id list divided by commas
required:
- id
responses:
'200':
description: Successful response.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
description: Determines if target was updated.
required:
- success
example:
success: true
'401':
description: Missing or invalid access token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Not divided by commas
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
widgets:
- '21'
errors:
- code: 100
title: Invalid Argument
detail: Invalid widget id 1000
x-codeSamples:
- lang: json
label: Add widget id
source: "curl -X POST \\\n -H \"Authorization: Bearer e62a04f681ba57d0120f8f584b688e31f04cf41d\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Cache-Control: no-cache\" \\\n -d '{\"id\": \"32,35,57\"}' \\\n 'https://api.revcontent.io/stats/api/v1.0/boosts/308/targets/blacklist/widgets/add'"
/stats/api/v1.0/boosts/{boost_id}/targets/blacklist/widgets/remove:
post:
operationId: postTargetsWidgetsOptimizerRemove
summary: Remove Widget Blacklist
description: Remove widget ids from Widget Blacklists.
tags:
- Widget Optimizer
x-permission:
- Advertiser
parameters:
- name: boost_id
in: path
required: true
description: Campaign ID.
schema:
type: number
- name: sub_account_id
in: query
required: false
description: Sub Account ID. By default all actions are for your user account if sub account ID is not specified.
schema:
type: number
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
id:
type: string
description: Widget id list divided by commas
required:
- id
responses:
'200':
description: Successful response.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
description: Determines if target was updated.
required:
- success
example:
success: true
'401':
description: Missing or invalid access token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Not divided by commas
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
widgets: []
errors:
- code: 100
title: Invalid Argument
detail: Invalid id value 21|1000
x-codeSamples:
- lang: json
label: Remove widget id
source: "curl -X POST \\\n -H \"Authorization: Bearer e62a04f681ba57d0120f8f584b688e31f04cf41d\" \\\n -H \"Content-Type: application/json\" \\\n -H \"Cache-Control: no-cache\" \\\n -d '{\"id\": \"32,35,57\"}' \\\n 'https://api.revcontent.io/stats/api/v1.0/boosts/308/targets/blacklist/widgets/remove'"
components:
schemas:
Error:
type: object
description: RevContent error envelope.
properties:
success:
type: boolean
const: false
errors:
type: array
items:
type: object
properties:
code:
type: integer
description: HTTP-aligned error code.
title:
type: string
description: Short error title.
detail:
type: string
description: Human readable error detail.
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: OAuth 2.0 client-credentials access token obtained from POST /oauth/token. Valid for 24 hours.
x-source: https://api.revcontent.io/docs/stats/api_data.json
x-source-format: apiDoc 0.17.7
x-generated: '2026-08-13'
x-method: derived