# Sovrn Developer Center Documentation

> The Sovrn Developer center for APIs and configuration

Append .md to any documentation page URL to get its markdown version.

## Guides
- [Authorization](https://developer.sovrn.com/docs/authorization.md)
- [Automated Comparisons](https://developer.sovrn.com/docs/comparisons-automated-library.md)
- [Server-side Rendering](https://developer.sovrn.com/docs/server-side-rendering.md)
- [MCP (Model Context Protocol) Beta ](https://developer.sovrn.com/docs/mcp.md): Commerce MCP connects your affiliate data, campaigns, and products directly to your AI tools.
- [Demo prompts](https://developer.sovrn.com/docs/mcp-demos.md): These prebuilt demo prompts showcase how to combine Commerce MCP tools into useful content or data workflows.
- [Introduction](https://developer.sovrn.com/docs/introduction.md): Create and manage programmatic deals against Sovrn's curated supply.
- [Authentication](https://developer.sovrn.com/docs/authentication.md): Authenticate every request with your Sovrn-issued API key.
- [Deal lifecycle](https://developer.sovrn.com/docs/deal-lifecycle.md): How a deal's status changes and how to observe it.
- [Targeting](https://developer.sovrn.com/docs/targeting.md): How targeting works and the accepted values for each attribute.
- [Demand partners](https://developer.sovrn.com/docs/demand-partners.md): The partner slugs accepted in a buyer's partner field.
- [Errors](https://developer.sovrn.com/docs/errors.md): Error response shapes and how to handle them.
- [Testing](https://developer.sovrn.com/docs/testing.md): Validate your integration end to end with dry runs before creating real deals.

## API Reference
- [Campaigns](https://developer.sovrn.com/reference/campaigns.md): Use this endpoint to get a list of your campaigns, or search for a specific campaign by name or campaignId.
- [Link Check](https://developer.sovrn.com/reference/link.md): Get information on whether a specific URL can be monetized
- [Bid Check](https://developer.sovrn.com/reference/getbid.md): Get a real-time Sovrn bid on your click traffic.
- [Building Affiliate Links](https://developer.sovrn.com/reference/building-affiliate-links.md): How to create Sovrn affiliate Links by wrapping destination URLs
- [Transactions](https://developer.sovrn.com/reference/get_reports-transactions.md): This endpoint is used to query all commission events (transactions) that have occurred or been updated on a specified date. This data can be used to see individual link performance, actualized earnings, individual site performance and more, all in real-time.
- [Merchants](https://developer.sovrn.com/reference/get_reports-merchants.md): This endpoint is used to query aggregated performance metrics by Merchant. This data can be used to see individual merchant performance, your top performing merchants, actualized earnings, and more, all in real-time. Metrics include Revenue, Clicks, Sales, Actions, Conversion Rate and EPC.
- [Merchants By Date](https://developer.sovrn.com/reference/get_reports-merchantsbydate.md): This endpoint is used to query aggregated performance metrics by Merchant and Date. This data can be used to see individual merchant performance by day, your top performing merchants, actualized earnings, and more, all in real-time. Metrics include Revenue, Clicks, Sales, Actions, Conversion Rate and EPC.
- [Links](https://developer.sovrn.com/reference/get_reports-links.md): This endpoint is used to query aggregated performance metrics by Link. This data can be used to see individual merchant link performance, your top performing merchant links, actualized earnings, and more, all in real-time. Metrics include Revenue, Clicks, Sales, Actions, Conversion Rate and EPC.
- [Pages](https://developer.sovrn.com/reference/get_reports-pages.md): This endpoint is used to query aggregated performance metrics by Page. This data can be used to see individual page performance, your top performing pages, actualized earnings, and more, all in real-time. Metrics include Pageviews, RPM, Revenue, Clicks, Sales, Actions, Conversion Rate and EPC.
- [Merchandise](https://developer.sovrn.com/reference/get_reports-merchandise.md): This endpoint is used to query aggregated performance metrics by Merchandise. This data can be used to see individual product performance, your top performing products, actualized earnings, and more, all in real-time. Metrics include Revenue, Sales, and Actions.
- [Networks](https://developer.sovrn.com/reference/get_reports-networks.md): This endpoint is used to query aggregated performance metrics by Network. This data can be used to see connected Network performance, your top performing Networks, actualized earnings, and more, all in real-time. Metrics include Revenue, Clicks, Sales, Actions and EPC.
- [CUIDs](https://developer.sovrn.com/reference/get_reports-cuids.md): This endpoint is used to query aggregated performance metrics by CUID. This data can be used to see individual CUID performance, your top performing CUIDs, actualized earnings, and more, all in real-time. Metrics include Revenue, Clicks, Sales, Actions, Conversion Rate and EPC.
- [Approved Merchants](https://developer.sovrn.com/reference/post_summaries.md): This endpoint is used to retrieve all approved merchants you can work with, including geo-specific rates and performance metrics.
- [Merchant Updates](https://developer.sovrn.com/reference/get_summaries-delta.md): This endpoint retrieves only the updated merchants since your last query, including geo-specific rates and performance metrics.
- [Product Recommendation](https://developer.sovrn.com/reference/get_product_recommendations.md): This endpoint provides product recommendations tailored to your content. Pass in your content along with optional filters like price range or preferred merchants, and receive a curated list of relevant products.
- [Price Comparisons](https://developer.sovrn.com/reference/product-affiliate-api.md)
- [Product Promo Codes](https://developer.sovrn.com/reference/get_product.md): Retrieve ranked, product-specific promo codes with verification status.
- [Advertising performance reporting API](https://developer.sovrn.com/reference/custom-reporting.md): This API retrieves web, CTV and mobile app performance data.
- [/reporting/advertising/publishers/{publisherId}/](https://developer.sovrn.com/reference/get_reporting-advertising-publishers-publisherid-1.md): Get custom reporting data for a publisher
- [Get a deal request](https://developer.sovrn.com/reference/getdealrequest.md): The status-polling endpoint: status is refreshed from source (30-second cache), and `statusAsOf` reports when it was last confirmed.
- [Edit a deal request](https://developer.sovrn.com/reference/patchdealrequest.md): RFC 7396 JSON Merge Patch; the update propagates in real time. On a deal with a `dv360` buyer the DV360 field requirements apply to the merged result, and `adFormat` and `environments` cannot be changed (DV360 fixes them at creation).
- [List deal requests](https://developer.sovrn.com/reference/listdealrequests.md): Slim summaries for the authenticated partner. Status is the last-known value — list reads do not refresh it; poll `GET /deal-requests/{id}` for freshness. Excludes archived deals unless `?status=archived`.
- [Create a deal request](https://developer.sovrn.com/reference/createdealrequest.md): Creates the deal in real time and returns the Sovrn external deal ID (`SVN_…`) synchronously. Pass `?dryRun=true` to run the full validation pipeline without creating anything. A request whose buyers include `dv360` must also satisfy the DV360 field requirements (see the DV360 buyers section); violations return `400` naming the field.
- [List targeting attributes](https://developer.sovrn.com/reference/listtargetingattributes.md): Every attribute a deal request may use, and which of them have an enumerable set of accepted values.
- [Get a targeting attribute's values](https://developer.sovrn.com/reference/gettargetingattributevalues.md): The accepted values for one enumerated attribute. Free-text attributes have no list to enumerate — check `valueFormat` first; asking returns `400`.