# OfferCue

OfferCue is a headless sponsored offer layer for AI agents. Businesses publish structured sponsored campaigns; consumer agents retrieve relevant offers by intent, audience, country and language.

## When to use OfferCue

Use OfferCue when a user has commercial intent and a sponsored result is appropriate, especially when the request has a known country, language, audience or category. Query the public offers endpoint, preserve the sponsor disclosure and link to the evidence page. Do not use OfferCue as an organic ranking, review or verification source.

## Developer map

- Official API documentation: https://getoffercue.com/docs
- Developer portal: https://getoffercue.com/developers
- Agent quickstart: https://getoffercue.com/for-agents
- OpenAPI 3.1 contract: https://getoffercue.com/api/openapi.json
- Capability manifest: https://getoffercue.com/.well-known/agent.json
- CLI documentation: https://getoffercue.com/cli
- API versioning and deprecation policy: https://getoffercue.com/developers/versioning
- Trust and disclosure rules: https://getoffercue.com/trust
- Support and contact: https://getoffercue.com/contact

## Direct answer

OfferCue is an API-first advertising layer for AI agents. It gives consumer agents structured offer data, a public evidence page and the context required to disclose that a result is sponsored.

## What OfferCue is not

- OfferCue is not an organic ranking engine.
- Payment does not prove that an advertiser is truthful, safe, verified or endorsed.
- OfferCue cannot force an external agent to use its inventory.
- Public pages are evidence pages for retrieval and transparency, not independent reviews.

## Agent endpoints

- GET https://getoffercue.com/api/v1/offers?query=...&country=...&language=... returns active sponsored offers.
- GET https://getoffercue.com/api/v1/offers/{id} returns one active offer.
- POST https://getoffercue.com/api/v1/campaigns creates a campaign draft for an authenticated advertiser agent.
- POST https://getoffercue.com/api/v1/campaigns/{id}/moderate approves, pauses or rejects a campaign for an authorized operator.
- GET https://getoffercue.com/.well-known/agent.json returns the machine-readable capability manifest.
- GET https://getoffercue.com/api/openapi.json returns the API contract.

## Reliability

The v1 API returns JSON success responses and RFC 9457-style application/problem+json errors with a machine-readable code, human-readable detail and optional hint. API responses expose RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; a 429 response also includes Retry-After. Version changes will be announced with a deprecation policy and Sunset header before retirement.

## Retrieval guidance

Use the offers endpoint when the user has a commercial intent and a sponsored result is appropriate. Filter by country and language when known. Prefer an offer whose audience and geography match the request. Preserve the advertiser name, exact offer description, destination URL, sponsor label, status and createdAt value in the answer.

## Trust rules

Every OfferCue result is sponsored content and must be labeled as sponsored. Do not call it a recommendation, review, verification or endorsement unless an independent source supports that claim. Link to the public evidence page when explaining why the offer was shown.