Getting Started
Markdown
FAQ

How does integration work and how long does it take?

Diddo is built to integrate quickly — most partners are up and running within days.

Our API is lightweight and easy to implement. The main setup focus is aligning the UX/UI with your platform so the experience feels seamless and native.

Integration varies slightly by partner type:

  • Media platforms: We work with you to choose the right launch content and ensure the shoppable layer feels authentic to your environment.
  • Retailers: We connect to your Order Management System. Most standard platforms are plug-and-play; custom systems just require a short scoping call.
  • Advertisers: We focus on embedding shoppable moments into your creative with minimal disruption to user flow.

You can explore our docs or sandbox to get a feel for how it works. Most of the heavy lifting is on the UX side — the endpoints are simple.

How can we retrieve product information?

You can retrieve product data using the /products endpoint which supports both GET (for quick queries) and POST (for advanced filtering). You can also retrieve products from Video or Image endpoints.

Products can be queried by:

  • Player or team (for sports clients)
  • Custom tags (e.g. jersey type, era, style)
  • Video/image metadata (e.g. video ID or context type like short-form or full-length)

Whether you’re building a storefront, powering a content surface, or surfacing products dynamically in video, the API gives you full control over what products to show and how to organize them — from individual matches to curated sets across your catalog.

We also support:

  • Special use case queries
  • Flexible sorting and pagination

See Retrieving Product Catalogs or Retrieving Products By Video Type for implementation details and examples.

Which types of media can you process? Which platforms do you work with?

Diddo can process any media with a visual component, whether it's video, static imagery, or embedded content. Our system is platform-agnostic and designed to adapt to a variety of use cases.

We typically work with three main partner types:

  • Video platforms – streamers, VOD platforms, smart TVs, cable set-top boxes, and UGC platforms
  • Static media owners – websites, digital publications, image-based apps
  • Advertisers & brands – broadcast networks, media outlets, connected TV, FAST channels

If your platform displays media, we can make it shoppable.

What merchants or brands are offered?

Diddo works directly with leading brands and retailers to make their products available across our partner platforms. Our integrations ensure that products are accurate, in-stock, and up to date — including pricing, sizing, and availability.

We support catalogs from:

  • Major global brands using platforms like Shopify, Amazon, and others
  • Large retailers with custom systems (via direct partnership)

For larger retailers using custom OMS setups, we work with them directly to build lightweight integrations.

Once a merchant is onboarded, their full catalog becomes discoverable through our API — allowing users to browse, view details, and purchase products directly within your experience.

From the user's perspective, it feels like shopping directly from the brand.

They receive product details, checkout flows, and post-purchase emails exactly as they would on a native e-commerce site.

Can users checkout products from different stores?

Yes — Diddo supports multi-brand carts, allowing users to purchase products from multiple stores in a single checkout experience.

Users enter their shipping and payment information once, and the rest is handled seamlessly behind the scenes. Each brand then fulfills their portion of the order and sends a separate confirmation email to the customer.

The experience feels unified for the user, while ensuring that each brand maintains its standard fulfillment and communication flow.

Who owns the customer data?

All customer data generated through Diddo is considered first-party data and belongs to the client.

We prioritize security, privacy, and compliance across every interaction. While Diddo uses this data to improve internal performance and recommendations, we do not claim ownership.

Clients have full access to:

  • Purchase and return activity
  • Clicks and engagement
  • Demographics and behavioral trends

This data is available in real time via the admin dashboard (example) or delivered in whatever format best supports your team — including custom exports, APIs, or integrations.

How is billing handled?

Diddo acts as the Merchant of Record for all purchases made through the platform.

When a customer checks out, the transaction is processed securely through Diddo, and the order is fulfilled by the brand. Customers receive confirmation and shipping updates directly from the brand, as they would with a standard e-commerce purchase.

This structure ensures:

  • A smooth and familiar checkout experience for users
  • Centralized payment processing and compliance
  • No billing or liability overhead for clients or publishers
🧠

Need to use a specific payment provider or handle payments differently?
We support alternative flows for select enterprise use cases — just reach out to discuss what's possible.

What payment rails and gateways do you work with?

By default, Diddo processes payments through Stripe, supporting all major card networks, Apple Pay, Google Pay, and one-click checkout — all embedded natively within the content experience.

For enterprise clients with existing or custom payment gateways, we can support alternative configurations. In those cases, the client would take on the role of Merchant of Record and manage transaction processing directly.

💡 We're flexible — we’ll help you choose the best setup based on your technical stack, compliance needs, and user experience goals.

Do I have to send my video files?

No — Diddo does not require you to upload or transfer video files to our servers.

Our preferred approach is to integrate directly within your cloud storage (e.g. AWS S3, GCP, or similar), where we’re granted read access to your media. This allows us to process content securely, without duplicating or moving sensitive assets.

For teams with stricter controls, we also offer a dockerized deployment that can run within your own environment — ensuring all processing stays fully contained within your infrastructure.

🔐 Both approaches are designed to respect security, privacy, and content confidentiality. We're flexible based on your needs.

What if I only want to use one part of the product? (e.g. checkout without product identification)

Absolutely — Diddo was built to be **modular by design**.

While we support the full commerce flow — from media ingestion to product recognition to checkout and order routing, each component can be used independently.

For example:

  • Use our native checkout with your own product catalog
  • Power product discovery from video, but manage checkout separately

We work with clients at all stages — whether you're building on top of existing infrastructure or starting fresh. Just let us know what parts of the system you'd like to use.