Scope3

Scope3 Measurement API

Measurement sources, records, context, and freshness

GitHub OpenAPI

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /advertisers/{advertiserId}/measurement-data/sync Sync performance measurement data · Sync measurement data #
Ask an LLM
“Can I send campaign performance data directly instead of using a conversions API?”
“What granularity can synced measurement data be keyed by?”
Tell an agent
Sync measurements {measurements} for advertiser {advertiserId}.
Push time-series performance data {measurements} to advertiser {advertiserId}.
GET /advertisers/{advertiserId}/test-cohorts List an advertiser's test cohorts · List test cohorts #
Ask an LLM
“Which test cohorts exist for my advertiser?”
“Can I list only active test cohorts, or filter by role?”
Tell an agent
List test cohorts for advertiser {advertiserId}.
Show active test cohorts with role {role} for advertiser {advertiserId}.
POST /advertisers/{advertiserId}/test-cohorts Create a measurement test cohort · Create test cohort #
Ask an LLM
“How do I set up a test cohort for incrementality measurement?”
“What definition does a new test cohort need?”
Tell an agent
Create test cohort {name} of type {cohortType} with definition {definition} for advertiser {advertiserId}.
Add a {cohortType} cohort named {name} defined as {definition} under advertiser {advertiserId}.
GET /advertisers/{advertiserId}/test-cohorts/{cohortId} Get a test cohort · Get test cohort #
Ask an LLM
“Can I see the definition of one test cohort?”
“What is the estimated size of a specific cohort?”
Tell an agent
Get test cohort {cohortId}.
Show the details of cohort {cohortId}.
PUT /advertisers/{advertiserId}/test-cohorts/{cohortId} Update a test cohort · Update test cohort #
Ask an LLM
“Can I change a test cohort's definition after creating it?”
“Is it possible to rename a cohort or switch its role?”
Tell an agent
Rename test cohort {cohortId} to {name}.
Change the definition of cohort {cohortId} to {definition}.
DELETE /advertisers/{advertiserId}/test-cohorts/{cohortId} Delete a test cohort · Delete test cohort #
Ask an LLM
“Can I remove a test cohort I no longer use?”
“Is deleting a measurement cohort reversible?”
Tell an agent destructive · confirm first
Delete test cohort {cohortId}.
Remove cohort {cohortId} from measurement.
GET /advertisers/{advertiserId}/measurement-config Get an advertiser's measurement settings · Get measurement configuration #
Ask an LLM
“Is media mix modeling or brand lift enabled for my advertiser?”
“What measurement configuration is set on an advertiser?”
Tell an agent
Get the measurement configuration for advertiser {advertiserId}.
Check if MMM is on for advertiser {advertiserId}.
PUT /advertisers/{advertiserId}/measurement-config Update an advertiser's measurement settings · Update measurement configuration #
Ask an LLM
“How do I turn on brand lift measurement for an advertiser?”
“Can I enable MMM and pass its configuration?”
Tell an agent
Enable MMM for advertiser {advertiserId}: {mmmEnabled}.
Set brand lift enabled to {brandLiftEnabled} on advertiser {advertiserId}.
GET /advertisers/{advertiserId}/measurement-sources List measurement sources · List measurement sources #
Ask an LLM
“Which measurement data sources are registered for my advertiser?”
“Can I filter measurement sources by outcome type?”
Tell an agent
List measurement sources for advertiser {advertiserId}.
Show {outcomeType} measurement sources for advertiser {advertiserId}.
POST /advertisers/{advertiserId}/measurement-sources Register a measurement source · Create measurement source #
Ask an LLM
“How do I register an MMM or brand lift study as a data source?”
“What cadence and granularity does a measurement source need?”
Tell an agent
Register source {name} ({sourceKey}) by {provider} on advertiser {advertiserId}: {outcomeType}, {granularity}, {cadence}.
Add a {cadence} {outcomeType} source {name} ({sourceKey}) by {provider} at {granularity} level to advertiser {advertiserId}.
GET /advertisers/{advertiserId}/measurement-sources/{sourceId} Get a measurement source · Get measurement source #
Ask an LLM
“Can I see how one measurement source is configured?”
“What attribution settings does a particular data source use?”
Tell an agent
Get measurement source {sourceId} for advertiser {advertiserId}.
Show the config of source {sourceId} on advertiser {advertiserId}.
PATCH /advertisers/{advertiserId}/measurement-sources/{sourceId} Update a measurement source · Update measurement source #
Ask an LLM
“Can I change the lag weeks or signal weight of a measurement source?”
“How do I pause a measurement source by changing its status?”
Tell an agent
Set the status of measurement source {sourceId} on advertiser {advertiserId} to {status}.
Change signal weight of source {sourceId} for advertiser {advertiserId} to {signalWeight}.
POST /advertisers/{advertiserId}/measurement-records Upload outcome measurement records · Upload measurement records #
Ask an LLM
“How do I upload sales or brand lift results for measurement?”
“Will re-uploading the same outcome window overwrite earlier records?”
Tell an agent
Upload outcome records {records} for advertiser {advertiserId}.
Upsert sales outcome records {records} to advertiser {advertiserId}.
GET /advertisers/{advertiserId}/measurement-records List uploaded measurement records · List measurement records #
Ask an LLM
“Which outcome records have I uploaded for a date range?”
“Can I filter measurement records by geo?”
Tell an agent
List measurement records for advertiser {advertiserId}.
Show {outcomeType} records for advertiser {advertiserId} in geo {geo} from {startDate} to {endDate}.
POST /advertisers/{advertiserId}/context-records Upload context data like promos or weather · Upload context records #
Ask an LLM
“Can I feed promotions or weather into measurement analysis?”
“Where do I upload external context data such as competitor activity?”
Tell an agent
Upload context records {records} for advertiser {advertiserId}.
Add promo and weather context {records} to advertiser {advertiserId}.
GET /advertisers/{advertiserId}/measurement-freshness Check gaps in measurement data · Check measurement freshness #
Ask an LLM
“Is any measurement data missing for my flight dates?”
“Which geos have stale measurement coverage?”
Tell an agent
Check measurement freshness for advertiser {advertiserId} from {flightStart} in geos {geos}.
Find measurement gaps for advertiser {advertiserId} between {flightStart} and {flightEnd} across {geos}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-measurement-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/scope3:scope3-measurement-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

scope3-measurement-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Scope3 Buyer Measurement API
  version: 2.0.0
  description: 'REST API for advertisers to manage advertisers, campaigns, and reporting.


    ## Authentication


    All endpoints require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer your-api-key

    ```


    ## Base URL


    `https://api.interchange.io/api/v2/buyer`


    ## For AI Agents


    AI agents can use the MCP endpoint at `/mcp/v2/buyer` with three tools:

    - `initialize`: Start an MCP session

    - `api_call`: Make REST API calls

    - `ask_about_capability`: Learn about API features'
servers:
- url: https://api.interchange.io/api/v2/buyer
  description: Production server
tags:


# --- truncated at 32 KB (50 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-measurement-api-openapi.yml