Hello, developers.

Promoted Placements for Developers

We’re building an API to help websites, apps, and AI agents integrate product discovery and eligible commerce monetization.

Early Access The API is in development and not yet publicly available.

The model

What are promoted placements?

Promoted placements are paid product results shown inside a product discovery experience: a search results list, a comparison page, or an answer from an AI assistant. They sit next to organic results and are labeled, so people can tell which results are promoted.

The model connects four things: product discovery, a visible promotion label, a purchase that can be attributed to the placement, and a commission for the publisher when that purchase qualifies.

  1. 1Product discovery
  2. 2Labeled promoted result
  3. 3Attributed purchase
  4. 4Commission, if the purchase is eligible

A click is not revenue

Showing or clicking a promoted result earns nothing by itself. A commission depends on an eligible purchase being attributed to the placement, under the rules of the program involved.

Disclosure comes with it

Promoted results need to be distinguishable from organic ones, with the paid relationship made clear to the person shopping.

Shopify offers one implementation

Shopify documents a promoted placement program for developers who use its Global Catalog. According to Shopify’s documentation, it is currently an invite-led Developer Preview and its details may change.

Read Shopify’s documentation

This site is independent

Promoted Placements is a separate developer service that is still being built. It is not operated, endorsed, or sponsored by Shopify.

Planned experience

How it works

This is the experience we’re building toward. It isn’t live yet, and details may change as we build.

  1. Apply for access

    Tell us which website, app, or agent you want to connect. During Early Access we review each request before inviting anyone.

  2. Add product discovery to what you’ve built

    Bring product discovery and eligible promoted results into your existing experience, labeled so your users can tell them apart from organic results.

  3. Send shoppers through attributed purchase links

    People reach products through attributed purchase links. Any earnings depend on the program that applies and on its eligibility rules.

For developers

Made for products people already use

We’re building for teams who run, or are building, something people use to find things.

AI assistants

For assistants and agents that get asked shopping questions and want to answer with products people can actually go and buy.

Content websites

For publishers, guides, and communities that want relevant product entry points inside their content without building a catalog integration.

Shopping tools

For search, comparison, and browser tools that would rather not maintain product data and attribution plumbing themselves.

What we plan to offer

  • Product discovery

    Find products relevant to what your user is looking for.

    In development
  • Attributed purchase links

    Links that carry attribution from your experience through to the purchase.

    In development
  • Developer integration tools

    Documentation and tooling for fitting this into a product you already run.

    In development

These are plans, not commitments. We’ll publish real documentation when there is a real API to document.

FAQ

Questions, answered plainly

What are promoted placements?

Promoted placements are paid product results that appear alongside organic results in a product discovery experience, such as a search results list or an answer from an AI assistant. They are labeled as promoted, and the publisher may earn a commission when a shopper completes an eligible purchase that is attributed to the placement.

Who is this platform for?

Developers and operators of websites, apps, and AI products: AI assistants and agents, content sites and communities, shopping search and browser tools. It is developer infrastructure, not a consumer shopping site.

Is this an official Shopify service?

No. Promoted Placements is an independent project. It is not operated, endorsed, or sponsored by Shopify. Shopify runs its own promoted placement program, which it documents on shopify.dev.

Is the API available now?

Not yet. The API is in development, and there are no public API keys, documentation, or developer dashboard today. You can apply for early access and we’ll contact you when access is available.

Do I need to run my own Shopify store?

This service is aimed at developers and site operators rather than merchants. The exact requirements for access are still being confirmed, and we’ll explain them before early access opens. We can’t promise eligibility in advance.

How is revenue generated?

In a promoted placement model, an eligible purchase that is attributed to a placement may earn a commission under the program that applies. Showing or clicking a result does not earn anything on its own. We are not promising earnings, commission rates, or revenue share at this stage.

What happens after I apply?

We receive your request and review the website and use case. When early access opens, we contact applicants whose products are a good fit. Not everyone will be invited, and applying does not by itself grant API access or eligibility for any commerce or commission program.

Got a product? Tell us.

Apply for Early Access

Leave your email and company or product website. We’ll contact you when early access is available.

Applying registers your interest. It doesn’t grant API access or eligibility for any commerce or commission program.

We use these details to review your request and contact you about early access. Applying doesn’t subscribe you to marketing email. See our Privacy notice.