Scope3

Scope3 Property Lists API

Validate property lists against AAO registry

GitHub OpenAPI

Operations 9

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

GET /advertisers/{advertiserId}/property-lists List an advertiser's property lists · List property lists #
Ask an LLM
“Which include and exclude domain lists does my advertiser have?”
“Can I list only my exclude lists?”
Tell an agent
List property lists for advertiser {advertiserId}.
Show {purpose} property lists for advertiser {advertiserId}.
POST /advertisers/{advertiserId}/property-lists Create an include or exclude domain list · Create property list #
Ask an LLM
“How do I build a blocklist of publisher domains for an advertiser?”
“What happens to domains that can't be resolved when I create a list?”
Tell an agent
Create a {purpose} list named {name} for advertiser {advertiserId} with domains {domains}.
Make an exclude property list {name} of purpose {purpose} under advertiser {advertiserId}.
GET /advertisers/{advertiserId}/property-lists/{listId} Get a property list · Get property list #
Ask an LLM
“Which domains are on one of my property lists?”
“Can I see the resolved identifiers for a list?”
Tell an agent
Get property list {listId} for advertiser {advertiserId}.
Show the domains on list {listId} of advertiser {advertiserId}.
PUT /advertisers/{advertiserId}/property-lists/{listId} Rename or replace domains on a property list · Update property list #
Ask an LLM
“Can I replace all the domains on an existing property list?”
“How do I rename a property list?”
Tell an agent
Replace the domains on list {listId} of advertiser {advertiserId} with {domains}.
Rename property list {listId} of advertiser {advertiserId} to {name}.
DELETE /advertisers/{advertiserId}/property-lists/{listId} Archive a property list · Delete property list #
Ask an LLM
“Does deleting a property list unlink it from targeting?”
“Can I retire a domain list I no longer use?”
Tell an agent destructive · confirm first
Delete property list {listId} from advertiser {advertiserId}.
Archive list {listId} of advertiser {advertiserId}.
GET /campaigns/{campaignId}/property-lists See which property lists apply to a campaign · Get campaign property lists #
Ask an LLM
“Which domain lists constrain where my campaign can deliver?”
“Are advertiser-level lists applied to a campaign too?”
Tell an agent
Get the property lists applying to campaign {campaignId}.
Show the include and exclude lists on campaign {campaignId}.
POST /campaigns/{campaignId}/property-lists Push an include list to a running campaign · Attach property list to campaign #
Ask an LLM
“Can I apply a new include list to media buys that are already running?”
“What kind of property list can be attached to a live campaign?”
Tell an agent
Attach property list {propertyListId} to campaign {campaignId}.
Push include list {propertyListId} to all active media buys of campaign {campaignId}.
POST /property-lists/check Check domains against the community registry · Check property list #
Ask an LLM
“Which of my domains should be removed or reviewed according to the registry?”
“Can I vet a domain list before using it?”
Tell an agent
Check domains {domains} against the registry.
Audit identifiers {identifiers} for remove, modify or assess flags.
GET /property-lists/reports/{reportId} Get a stored domain check report · Get property list check report #
Ask an LLM
“Can I retrieve a property list check report I ran earlier?”
“How long are domain check reports kept?”
Tell an agent
Get property list check report {reportId}.
Show results of domain check {reportId}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-property-lists-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-property-lists-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-property-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Scope3 Buyer Property Lists 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 (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-property-lists-api-openapi.yml