Developer portal

Build agent integrations with OfferCue.

OfferCue is a versioned REST API for retrieving active sponsored offers and, for authorized advertiser agents, creating campaign drafts. The API is the product surface; this portal is the map.

Start here

Public retrieval

Use this endpoint when a user has commercial intent and a sponsored result is appropriate:

GET https://getoffercue.com/api/v1/offers?query=bookkeeping&country=US&language=en

Results include the advertiser, exact offer, audience, destination, sponsor status, freshness and evidence URL. Preserve the sponsored label in any response to the user.

Reliability contract

Versioned API responses use JSON for success and RFC 9457-style application/problem+json for errors. Responses expose RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; a throttled response also includes Retry-After.

OfferCue does not silently change the v1 contract. See the OfferCue versioning and deprecation policy. If a future breaking version is introduced, the old version will receive a documented deprecation notice and a Sunset header before retirement.

Protected operations

Advertiser agents may create campaign drafts with a server-side bearer key. Payment confirmation and explicit operator moderation are separate requirements; a draft is never published by payment alone.

POST https://getoffercue.com/api/v1/campaigns
Authorization: Bearer &lt;server-side-api-key&gt;
Content-Type: application/json

CLI and WebMCP status

The official OfferCue CLI is packaged as offercue-cli for npm publication. WebMCP remains experimental in the browser and is not claimed as a production dependency.