OpenAPI Specification
openapi: 3.0.3
info:
title: RevContent Stats & Management Access Targeting API
description: 'REST API providing programmatic access to RevContent''s native advertising platform for managing boosts (campaigns), widgets, content, targeting, bidding, and statistical reporting. Authenticated via OAuth 2.0 client credentials flow. Access tokens are valid for 24 hours.
'
version: '1.0'
contact:
name: RevContent Support
url: https://www.revcontent.com/resources/contact-us
email: developer@revcontent.com
x-api-changelog: https://help.revcontent.com/knowledge/api-changelog
servers:
- url: https://api.revcontent.io
description: RevContent Production API
security:
- BearerAuth: []
tags:
- name: Targeting
description: Widget and audience targeting
paths:
/stats/api/v1.0/boosts/{boost_id}/targets/widgets:
get:
operationId: getBoostWidgetTargets
summary: Get Boost Widget Targets
description: Retrieves targeting configurations for a specific boost's widgets.
tags:
- Targeting
parameters:
- name: boost_id
in: path
required: true
schema:
type: integer
description: Unique identifier of the boost
responses:
'200':
description: Widget targeting configurations
content:
application/json:
schema:
$ref: '#/components/schemas/WidgetTargetsResponse'
'401':
description: Unauthorized
post:
operationId: updateBoostWidgetTargets
summary: Update Boost Widget Targets
description: 'Applies targeting rules to a boost''s widgets. Validates widget IDs and enforces a $0.01 minimum bid.
'
tags:
- Targeting
parameters:
- name: boost_id
in: path
required: true
schema:
type: integer
description: Unique identifier of the boost
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateWidgetTargetsRequest'
responses:
'200':
description: Targeting updated successfully
'400':
description: Invalid widget IDs or bid below minimum
'401':
description: Unauthorized
components:
schemas:
UpdateWidgetTargetsRequest:
type: object
required:
- targets
properties:
targets:
type: array
items:
type: object
required:
- widget_id
properties:
widget_id:
type: integer
description: Validated widget identifier
bid:
type: number
format: float
minimum: 0.01
description: Per-widget bid (minimum $0.01)
enabled:
type: boolean
description: Enable or disable this widget target
WidgetTargetsResponse:
type: object
properties:
data:
type: array
items:
type: object
properties:
widget_id:
type: integer
enabled:
type: boolean
description: Whether targeting for this widget is enabled
bid:
type: number
format: float
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: OAuth 2.0 Bearer token obtained from /oauth/token