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.
Hello, 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
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.
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.
Promoted results need to be distinguishable from organic ones, with the paid relationship made clear to the person shopping.
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.
Promoted Placements is a separate developer service that is still being built. It is not operated, endorsed, or sponsored by Shopify.
Planned experience
This is the experience we’re building toward. It isn’t live yet, and details may change as we build.
Tell us which website, app, or agent you want to connect. During Early Access we review each request before inviting anyone.
Bring product discovery and eligible promoted results into your existing experience, labeled so your users can tell them apart from organic results.
People reach products through attributed purchase links. Any earnings depend on the program that applies and on its eligibility rules.
For developers
We’re building for teams who run, or are building, something people use to find things.
For assistants and agents that get asked shopping questions and want to answer with products people can actually go and buy.
For publishers, guides, and communities that want relevant product entry points inside their content without building a catalog integration.
For search, comparison, and browser tools that would rather not maintain product data and attribution plumbing themselves.
Find products relevant to what your user is looking for.
Links that carry attribution from your experience through to the purchase.
Documentation and tooling for fitting this into a product you already run.
These are plans, not commitments. We’ll publish real documentation when there is a real API to document.
FAQ
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.
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.
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.
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.
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.
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.
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.
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.