Scope3

Scope3 Storefronts API

The Storefronts API from Scope3 — 18 operation(s) for storefronts.

GitHub OpenAPI

Operations 19

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 /storefronts List storefronts I can buy from · List storefronts #
Ask an LLM
“Which storefronts are available for me to buy media from?”
“Can I filter storefronts by channel, region or publisher domain?”
Tell an agent
List the storefronts available to me.
List {channel} storefronts in {region}.
GET /storefronts/{storefrontId} View a storefront and my connection status · Get storefront #
Ask an LLM
“Am I connected to a particular storefront?”
“Can I see one storefront's details by id?”
Tell an agent
Show storefront {storefront_id}.
Check my connection status for storefront {storefront_id}.
GET /storefronts/{storefrontId}/capabilities Diagnose a storefront's source capabilities · Get storefront capabilities #
Ask an LLM
“What can each inventory source in a storefront actually do?”
“Why might a storefront source not support what I need?”
Tell an agent
Show capability diagnostics for storefront {storefront_id}.
Inspect what each source in storefront {storefront_id} supports.
GET /storefront-connections List my storefront connections and sharing settings · List storefront connections #
Ask an LLM
“Which storefronts have I connected and are buying, events and feeds turned on?”
“Is my delegated auth to an adapter storefront still valid?”
Tell an agent
List my storefront connections.
Show my connection and sharing settings for storefront {storefront_id}.
GET /storefront-connection-account-mappings List external accounts and their advertiser mappings · List external account mappings #
Ask an LLM
“Which external ad accounts are mapped to which of my advertisers across integrations?”
“Can I find external accounts that aren't mapped to an advertiser yet?”
Tell an agent
List external account mappings across all my integrations.
Show external accounts with mapping status {mapping_status} for provider {provider}.
GET /storefront-connections/{connectionId}/accounts List external accounts found on one connection · List integration external accounts #
Ask an LLM
“What external accounts were discovered on a specific integration connection?”
“Which ad accounts came through after I connected a platform?”
Tell an agent
List external accounts discovered on connection {connection_id}.
Show the accounts and advertiser mappings for connection {connection_id}.
DELETE /storefront-connections/{connectionId} Disconnect from an adapter storefront · Remove storefront connection #
Ask an LLM
“How do I disconnect an integration to an adapter storefront?”
“Is removing a storefront connection an archive or a hard delete?”
Tell an agent destructive · confirm first
Remove storefront connection {connection_id}.
Archive my integration connection {connection_id}.
PATCH /storefront-connections/{connectionId}/accounts/{accountId}/select Choose which external account a connection uses · Select integration external account #
Ask an LLM
“My connection found several ad accounts — how do I pick the one to use?”
“Can I switch the selected external account on an integration?”
Tell an agent
Select account {account_id} on connection {connection_id}.
Use external account {account_id} as the active one for connection {connection_id}.
POST /storefront-connections/{connectionId}/accounts/{accountId}/advertiser Map an external account to an advertiser · Map external account to advertiser #
Ask an LLM
“How do I link an external ad account to one of my advertisers?”
“Can I scope an account mapping to a specific source?”
Tell an agent
Map external account {account_id} on connection {connection_id} to advertiser {advertiser_id}.
Link account {account_id} (connection {connection_id}) to advertiser {advertiser_id} for source {source_id}.
POST /storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscribe Mirror an account's upstream campaigns · Subscribe a directed-campaign account (alpha) #
Ask an LLM
“Can I bring the campaigns already running in an external ad account into view here?”
“How much history comes over when I subscribe an account to directed campaigns?”
Tell an agent
Subscribe account {account_id} on connection {connection_id} to directed campaigns for advertiser {advertiser_id}.
Start mirroring upstream campaigns from account {account_id} (connection {connection_id}) into advertiser {advertiser_id}.
GET /storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription Check directed-campaign sync health · Get directed-campaign subscription health (alpha) #
Ask an LLM
“When did my mirrored campaigns last sync, and did it succeed?”
“How fresh is the directed-campaign data for a connected account?”
Tell an agent
Check directed-campaign subscription health for account {account_id} on connection {connection_id}.
Show the latest campaign mirror sync for account {account_id}, connection {connection_id}.
DELETE /storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription Stop mirroring an account's campaigns · Unsubscribe a directed-campaign account (alpha) #
Ask an LLM
“How do I stop mirroring campaigns from an external account?”
“What happens to the mirrored directed campaigns when I unsubscribe?”
Tell an agent destructive · confirm first
Unsubscribe account {account_id} on connection {connection_id} from directed campaigns.
Retire the campaign mirrors for account {account_id} (connection {connection_id}).
GET /storefront-connections/{connectionId}/accounts/{accountId}/presences List audiences and event sources on a connected account · List account presences (alpha) #
Ask an LLM
“Which audiences and event sources exist on a connected ad account?”
“Can I see sync status for audiences I pushed to an external account?”
Tell an agent
List audiences and event sources on account {account_id}, connection {connection_id}.
Show {object_type} presences for account {account_id} on connection {connection_id}, including retired ones.
PATCH /storefronts/{storefrontId}/connection-policy Turn buying, events or feed sharing on or off · Update storefront connection policy #
Ask an LLM
“Can I stop buying from a storefront without disconnecting it?”
“How do I turn off sending conversion events to a storefront?”
Tell an agent
Turn buying from storefront {storefront_id} to {buy_enabled}.
Set event sharing to {events_enabled} and feed sharing to {feeds_enabled} for storefront {storefront_id}.
POST /storefronts/{storefrontId}/connection Connect to an adapter storefront · Connect storefront #
Ask an LLM
“How do I connect my ad platform account so I can buy through it?”
“What do I do with the connection URL returned when connecting a storefront?”
Tell an agent
Connect me to storefront {storefront_id}.
Resume my integration with storefront {storefront_id} and give me the handoff link.
GET /storefronts/credentials List my registered storefront credentials · List credentials #
Ask an LLM
“Which credentials have I registered for storefront sources?”
“Which inventory sources does each of my credentials unlock?”
Tell an agent
List my registered storefront credentials.
Show which sources each of my credentials gives access to.
POST /storefronts/{storefrontId}/sources/{sourceId}/credentials Register credentials for an inventory source · Register source credentials #
Ask an LLM
“How do I give my account credentials to an inventory source inside a storefront?”
“Can I register a marketplace account for a storefront source?”
Tell an agent
Register account {account_identifier} for source {source_id} in storefront {storefront_id}.
Add credentials {auth} for account {account_identifier} on source {source_id} of storefront {storefront_id}.
POST /storefronts/{storefrontId}/sources/{sourceId}/adcp-connection Connect a registered AdCP source account · Connect a registered AdCP source (alpha) #
Ask an LLM
“Once an AdCP source account is registered and mapped, how do I connect it for campaigns?”
“Do I need to supply endpoint URLs or secrets to connect an AdCP source?”
Tell an agent
Connect AdCP source {source_id} in storefront {storefront_id} for advertiser {advertiser_id} and account {account_id}.
Project AdCP account {account_id} on source {source_id} (storefront {storefront_id}) for advertiser {advertiser_id} with credential {credential_id}.
GET /storefronts/{storefrontId}/publishers List publisher domains a storefront covers · List publisher domains for a storefront #
Ask an LLM
“Which publisher domains can I reach through a storefront?”
“Can I see only the domains verified by adagents.json?”
Tell an agent
List publisher domains for storefront {storefront_id}.
Show only verified publisher domains in storefront {storefront_id}.

Specifications

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