# RevContent

> RevContent is a native advertising and content-recommendation network. Publishers embed a
> JavaScript or mobile widget; advertisers buy that inventory with CPC/vCPM campaigns. The
> Stats & Management REST API at https://api.revcontent.io covers campaigns (boosts), creative
> content, widget targeting, widget blacklisting, conversion pixels, sub accounts, publisher widget
> reporting, CCPA data requests, and the reference lookups those depend on.

Generated by API Evangelist on 2026-08-13. RevContent does not serve an llms.txt of its own —
https://www.revcontent.com/llms.txt, https://help.revcontent.com/llms.txt and
https://api.revcontent.io/llms.txt all returned 404 on 2026-08-13.

## What an agent needs to know first

- Base URL: `https://api.revcontent.io`
- Auth: OAuth 2.0 client credentials. `POST /oauth/token` (form-encoded) returns a bearer token
  valid **24 hours**. No refresh token. Credentials come from Account Settings → "Stats API
  Credentials", and only after a RevContent account representative enables API access.
- The API is **not self-serve**: you cannot obtain working credentials without a human at RevContent.
- Machine-readable contract: RevContent publishes **apiDoc**, not OpenAPI. The real file is
  https://api.revcontent.io/docs/stats/api_data.json (43 operations, regenerated 2026-07-31).
- Errors are a vendor envelope, not RFC 9457: `{"success": false, "errors":[{code,title,detail}]}`.
- **No idempotency key exists anywhere in this API.** Writes are unsafe to retry blind.
- No published rate limits and no rate-limit response headers.
- No webhooks, no events, no MCP server, no A2A agent card.

## APIs

- [RevContent Stats & Management API](https://help.revcontent.com/knowledge/publisher-advertiser-api-requests): the human guide to authentication and getting access
- [RevContent API reference](https://api.revcontent.io/docs/stats/index.html): the full generated reference, 43 operations across 11 groups
- [CCPA Data Request API](https://help.revcontent.com/knowledge/ccpa-data-request-data-deletion-request-api): consumer access and deletion requests

## Specs

- [Access API](openapi/revcontent-access-api-openapi.yml): token issuance, account reactivation (2 operations)
- [Campaigns / Boosts API](openapi/revcontent-boosts-api-openapi.yml): create, update, list, archive, status, performance (7 operations)
- [Content API](openapi/revcontent-content-api-openapi.yml): creatives on a campaign and their per-widget stats (5 operations)
- [Targeting API](openapi/revcontent-targeting-api-openapi.yml): per-campaign widget targets and bid overrides (2 operations)
- [Widget Optimizer API](openapi/revcontent-widget-optimizer-api-openapi.yml): campaign-level widget blacklisting (3 operations)
- [Conversions API](openapi/revcontent-conversions-api-openapi.yml): conversion pixels for CPA optimization (4 operations)
- [Widgets API](openapi/revcontent-widgets-api-openapi.yml): publisher inventory, geo stats, Sub ID stats (3 operations)
- [Widget Internal Content API](openapi/revcontent-widget-internal-content-api-openapi.yml): publisher-owned content inside a widget (3 operations)
- [Sub Accounts API](openapi/revcontent-sub-accounts-api-openapi.yml): child account create, edit, list, enable/disable (4 operations)
- [Helpers API](openapi/revcontent-helpers-api-openapi.yml): browsers, countries, devices, DMAs, languages, operating systems, regions (7 operations)
- [CCPA API](openapi/revcontent-ccpa-api-openapi.yml): submit, retrieve, bulk retrieve (3 operations)
- [apiDoc source](openapi/_original/revcontent-apidoc-api_data.json): RevContent's own published contract, saved verbatim

## Agent artifacts

- [Agent Skills index](skills/_index.yml): five packaged flows grounded in real operationIds
- [Launch a campaign](skills/revcontent-launch-campaign.md)
- [Optimize widget spend](skills/revcontent-optimize-widget-spend.md)
- [CPA conversion tracking](skills/revcontent-conversion-tracking.md)
- [Publisher widget reporting](skills/revcontent-publisher-reporting.md)
- [CCPA data request](skills/revcontent-ccpa-data-request.md)
- [Agentic access contracts](agentic-access/revcontent-agentic-access.yml): recommended x-agentic-access execution contracts for all 43 operations
- [MCP candidate tools](mcp/revcontent-mcp.yml): derived candidate tool list — RevContent ships no MCP server

## Semantics

- [API conventions](conventions/revcontent-conventions.yml): auth, pagination, filtering, tenancy, versioning, error envelope, the absence of idempotency
- [Error catalog](errors/revcontent-problem-types.yml): the vendor error envelope and its failure modes
- [Data model](data-model/revcontent-data-model.yml): entity graph and relationships
- [Authentication](authentication/revcontent-authentication.yml)
- [Rate limits](rate-limits/revcontent-rate-limits.yml): none published
- [Lifecycle](lifecycle/revcontent-lifecycle.yml): versioning, deprecations, and the absent status page
- [Changelog](changelog/revcontent-changelog.yml): dated entries through 2021-09-13, plus the drift since
- [Conformance](conformance/revcontent-conformance.yml): standards and compliance posture
- [Well-known probe](well-known/revcontent-well-known.yml): 24 paths, 0 documents

## SDKs and embeds

- [Packages](packages/revcontent-packages.yml): the three first-party widget SDKs and their versions
- [Components](components/revcontent-components.yml): the web ad code, AMP widgets, RevMore, Sub IDs
- [@revcontent/react-native-sdk](https://www.npmjs.com/package/@revcontent/react-native-sdk): 1.1.1
- [revcontent-ios-sdk](https://github.com/RevContent/revcontent-ios-sdk): 0.2.0, Swift Package Manager
- [revcontent-android-sdk](https://github.com/RevContent/revcontent-android-sdk): 0.2.1, self-hosted Maven repo
- [adcode-devkit](https://github.com/RevContent/adcode-devkit): publisher ad-code developer guide

## Company

- [Website](https://www.revcontent.com)
- [Help centre](https://help.revcontent.com/knowledge)
- [Blog](https://www.revcontent.com/resources/blog)
- [Advertisers](https://www.revcontent.com/advertisers/)
- [Publishers](https://www.revcontent.com/publishers)
- [Security policy](https://www.revcontent.com/policy/security)
- [Privacy policy](https://www.revcontent.com/policy/privacy-policy)
- [Cookie policy](https://www.revcontent.com/policy/cookie-policy)
- [Contact](https://www.revcontent.com/resources/contact-us)
- [GitHub](https://github.com/RevContent)