# Outbrain (Teads)

> Outbrain Inc. (NASDAQ: OB), which closed its acquisition of Teads in early 2025 and now operates publicly as Teads, is one of the largest open-internet advertising platforms — reaching 2 billion+ consumers per month across 50+ markets with 20,000+ direct advertisers and 10,000+ premium media properties. Its developer surface has three distinct halves: the Outbrain Amplify API for programmatic campaign management and performance reporting, the Teads Report API for asynchronous analytics, and a publisher-side integration layer of mobile SDKs, JS widgets and a conversational-AI ad SDK.

Generated by API Evangelist from the artifacts in this repository (github.com/api-evangelist/outbrain).
Outbrain does not publish an llms.txt of its own; /llms.txt returns 404 on developer.outbrain.com and
developers.teads.com. This file is a faithful index of what Outbrain actually publishes.

## What an agent can and cannot do here

- The Amplify API is a real, callable REST API with 77 documented operations — but access is gated:
  Outbrain admits partners through an application at https://www.outbrain.com/partner-api/.
- Authentication is an opaque `OB-TOKEN-V1` header token, valid 30 days, obtained from `GET /login`
  (HTTP Basic, capped at 2 requests per hour per user) or https://my.outbrain.com/create-token.
- There is NO idempotency key on any Outbrain API. Retried writes create duplicates.
- There is NO MCP server. Teads has announced one as "In Development" for 2026 on the AI Chatbot SDK.
- There is NO A2A agent card, no webhooks, no AsyncAPI, no status page and no published SLA.
- Errors are proprietary JSON, not RFC 9457. Amplify returns `{moreInfo, errorMessage}`; the Teads
  Report API returns `{status, msg}` with dotted `REPORTING.ERROR.*` codes.

## APIs

- [Outbrain Amplify API](https://amplifyv01.docs.apiary.io/): Campaign management and performance reporting. Base URL https://api.outbrain.com/amplify/v0.1 — marketers, budgets, campaigns, promoted links, segments, conversion events, geo/interest/IAB targeting and 23 reporting endpoints.
- [Teads Report API](https://teadsapi.docs.apiary.io/): Asynchronous analytics reporting. Base URL https://api.teads.tv/v1/analytics — POST a report, poll it, download CSV/JSON/XLSX. OAuth bearer auth.
- [Outbrain Engage API](https://developer.outbrain.com/apis/): Publisher-side content recommendations. Base URL https://odb.outbrain.com — recommendation retrieval plus impression and click reporting.
- [Teads Advertiser Conversion API](https://github.com/teads/teads-advertiser-conversion-api-gtm-template): Server-to-server conversion events for cookieless measurement. Base URL https://r.teads.tv.
- [Teads In-Chat API v2.0](https://developers.teads.com/docs/Chatbot-AI-SDK/Getting-Started/integration-guide): Contextual sponsored recommendations for chatbot and LLM publishers. Base URL https://mv.outbrain.com/Multivac/api/in-chat-recs. Public beta since 2025-11-12.

## Specs

- [Amplify API OpenAPI 3.1 (77 operations)](openapi/outbrain-amplify-api-full-openapi.yml): Transcribed from Outbrain's own Apiary blueprint.
- [Teads Report API OpenAPI 3.1](openapi/outbrain-teads-report-api-openapi.yml)
- [Amplify API Blueprint (verbatim, as published)](openapi/_original/outbrain-amplify-api-apiary-blueprint.json)
- [Teads Report API Blueprint (verbatim, as published)](openapi/_original/outbrain-teads-report-api.apib)
- [Engage API OpenAPI](openapi/_original/outbrain-engage-api-openapi.yml)
- [Teads Conversion API OpenAPI](openapi/_original/outbrain-teads-conversion-api-openapi.yml)

## Runtime semantics

- [API conventions](conventions/outbrain-conventions.yml): auth, pagination, extraFields expansion, AMPLIFY-REQUEST-ID tracing, versioning, error envelopes, rate-limit signalling — recorded separately per API because the two do not agree.
- [Rate limits](rate-limits/outbrain-rate-limits.yml): /login 2/hour/user; token 30/second; performance reporting 30/minute/marketer; realtime reporting 50/minute/marketer. 429 carries `rate-limit-msec-left`.
- [Error catalog](errors/outbrain-problem-types.yml) and [Teads REPORTING.ERROR codes](errors/outbrain-error-codes.yml)
- [Authentication profile](authentication/outbrain-authentication.yml)
- [Lifecycle, versioning and deprecations](lifecycle/outbrain-lifecycle.yml)
- [Data model](data-model/outbrain-data-model.yml): Marketer → Budget → Campaign → PromotedLink, plus segments, conversion events and reporting projections.
- [Changelog](changelog/outbrain-changelog.yml): dated Amplify API updates and per-platform SDK release notes.
- [Sandbox and test values](sandbox/outbrain-sandbox.yml): no API test mode; published test placement ids, widget ids and installation keys for SDK integration.

## Agent surfaces

- [MCP](mcp/outbrain-mcp.yml): none published. Announced In Development for 2026; candidate tool list derived from the OpenAPI.
- [Agent skills](skills/_index.yml): four packaged flows — authenticate, launch a campaign, pull performance, run a Teads report.
- [Agentic access contracts](agentic-access/outbrain-agentic-access.yml)
- A2A agent card: none. Probed on every host at both `/.well-known/agent-card.json` and `/.well-known/agent.json`.

## SDKs and components

- [Packages](packages/outbrain-packages.yml): teads-react-native (npm 6.2.0), outbrain-react-native (npm 1.0.1), TeadsSDK (CocoaPods 6.2.0), tv.teads.sdk.android:sdk 6.2.1 (Teads Artifactory, not Maven Central). No server-side SDK for the Amplify or Report APIs in any language.
- [Embedded components](components/outbrain-components.yml): Outbrain SmartFeed web widget, Teads mobile placements (inRead, media, native, anchored banner, interstitial), the Conversational AI Ads SDK, and first-party GTM templates.
- [Postman collections](https://www.postman.com/kinlaneapi/outbrain/overview)

## Security and compliance

- [security.txt](well-known/outbrain-security.txt) — served at /.well-known/security.txt on www.outbrain.com, api.outbrain.com and odb.outbrain.com
- [Vulnerability disclosure](security/outbrain-vulnerability-disclosure.yml): https://www.outbrain.com/security/bug-bounty/
- [Trust centre](security/outbrain-trust-center.yml): SOC 2, ISO/IEC 27001
- [Domain security probe](security/outbrain-domain-security.yml)
- [Standards conformance](conformance/outbrain-conformance.yml): IAB taxonomy, TCF 2.3, GPP, Open Measurement, Prebid/OpenRTB and ads.txt are all supported; OAuth 2.0 discovery, RFC 9457, RFC 8594 and standard RateLimit headers are not.

## Docs

- [Outbrain Developer Center](https://developer.outbrain.com)
- [Teads Developer Portal](https://developers.teads.com)
- [Amplify API reference](https://amplifyv01.docs.apiary.io/)
- [Teads API reference](https://teadsapi.docs.apiary.io/)
- [Amplify API access request](https://www.outbrain.com/partner-api/)
- [Amplify API Google Group](https://groups.google.com/g/outbrain-amplifyapi)
- [Teads support](https://support.teads.com)