Scope3

Scope3 Product Discovery API

Discover and select products

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

POST /products/query Query products across connected storefronts · Get products across storefronts #
Ask an LLM
“Can I send one product request to all my connected storefronts at once?”
“Is there a way to have proposals screened against my buying instructions across storefronts?”
Tell an agent
Query every connected storefront for {buying_mode} products matching brief {brief}.
Run a cross-storefront get_products in {buying_mode} mode with filters {filters}.
POST /media-buys/batch Stage products from a multi-storefront query on a campaign · Stage or execute products across storefronts #
Ask an LLM
“After querying several storefronts, how do I put the chosen products into a draft campaign cart?”
“Can I execute media buys straight from a cross-storefront product query?”
Tell an agent
Stage selections {selections} from product query {query_id} on campaign {campaign} in {mode} mode.
Execute the media buys for {selections} from query {query_id} on campaign {campaign} using mode {mode}.
POST /discovery/discover-products Start a product discovery session for an advertiser · Discover products #
Ask an LLM
“How do I find ad products that fit my campaign brief and budget?”
“Can I narrow product discovery to certain channels and countries?”
Tell an agent
Discover products for advertiser {advertiser_id} matching brief {brief}.
Find {channels} products in {countries} for advertiser {advertiser_id} with a budget of {budget}.
GET /discovery/{discoveryId}/discover-products Browse products in an existing discovery session · Browse products for discovery session #
Ask an LLM
“Can I page through more publishers in a discovery session I already started?”
“What new products have arrived in my discovery session since the last revision?”
Tell an agent
Browse more products in discovery session {discovery_id}.
Show products from publisher {publisher_domain} in discovery {discovery_id}.
GET /discovery/{discoveryId}/products/{productId}/details View full details of a discovered product · Get product details #
Ask an LLM
“What pricing, delivery windows and creative formats does a discovered product require?”
“Why do I need the sales agent id to see a product's details?”
Tell an agent
Show details for product {product_id} in discovery {discovery_id} from sales agent {sales_agent_id}.
Get the creative format requirements of product {product_id} (discovery {discovery_id}, agent {sales_agent_id}).
GET /discovery/{discoveryId}/products List products selected in a discovery session · Get selected products #
Ask an LLM
“Which products have I picked so far in a discovery session?”
“Can I review my current product selection before building the buy?”
Tell an agent
List the products I've selected in discovery {discovery_id}.
Show my current selection for discovery session {discovery_id}.
POST /discovery/{discoveryId}/products Add discovered products to my selection · Add products to selection #
Ask an LLM
“How do I add a discovered product to my selection?”
“Can I replace my whole selection with a new set of products?”
Tell an agent
Add products {products} to my selection in discovery {discovery_id}.
Replace the selection in discovery {discovery_id} with {products} for campaign {campaign_id}.
DELETE /discovery/{discoveryId}/products Remove products from my selection · Remove products from selection #
Ask an LLM
“Can I drop a product I selected by mistake in a discovery session?”
“How do I take several products out of my selection at once?”
Tell an agent destructive · confirm first
Remove products {product_ids} from my selection in discovery {discovery_id}.
Unselect product {product_ids} in discovery session {discovery_id}.
POST /discovery/{discoveryId}/apply-proposal Apply a sales agent's proposal to my selection · Apply a proposal #
Ask an LLM
“Can a sales agent's proposal add products with suggested budget splits for me?”
“What must I do before I can apply a proposal?”
Tell an agent
Apply proposal {proposal_id} to discovery {discovery_id}.
Apply proposal {proposal_id} in discovery {discovery_id} with a total budget of {total_budget}.

Specifications

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