API Keys & Integrations

Connect PubPerf to your systems via API keys and SAML SSO

API Keys & Integrations

PubPerf provides API keys for programmatic access and supports SAML-based Single Sign-On (SSO) for enterprise authentication.

API Keys

API keys allow you to integrate PubPerf data with your own systems, scripts, or third-party tools.

Creating an API Key

  1. Navigate to Connect > API from the sidebar.
  2. Click Create new secret key.
  3. Click Show API key to reveal and copy it.

Using an API Key

Send the key in the Authorization header of every request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://app.pubperf.com/api/open/ORG_ID/prebid/report?start=2026-10-01&end=2026-10-07"

Listing Your Projects

Routes that take a project need its id. List the organization's projects to get them:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://app.pubperf.com/api/open/ORG_ID/projects"
{ "projects": [{ "id": "4d73dea306", "name": "www.example.com", "domain": "www.example.com" }] }

See Prebid Report API for pulling bid-level data into Tableau or another BI tool.

Managing API Keys

  • Regenerate — Generate a new secret for an existing API key. The old key will immediately stop working.
  • Enable/Disable — Toggle a key's active status.

Best Practices

  • Use separate API keys for different applications or environments.
  • Rotate keys periodically for security.
  • Disable keys immediately if they may have been compromised.
  • Never expose API keys in client-side code or public repositories.

SAML Single Sign-On

Enterprise organizations can configure SAML-based SSO to allow team members to authenticate using their existing identity provider (IdP).

Configuring SAML

  1. Navigate to Connect > SAML from the sidebar.
  2. Enter your Identity Provider's SAML metadata:
    • SSO URL — Your IdP's Single Sign-On endpoint.
    • Entity ID — Your IdP's entity identifier.
    • Certificate — The X.509 certificate from your IdP.
  3. Save the configuration.

Once configured, team members can log in using the SSO option on the login page. The SSO URL is unique to your organization.

MCP (Model Context Protocol)

PubPerf includes a built-in MCP server that lets AI assistants query your analytics data using your API key. See MCP Integration for setup instructions.

Connection Overview

The Connect page provides a summary of all active integrations for your organization, including the number of API keys in use and SAML configuration status.