Getting Started
Markdown
Introduction

Welcome to Diddo's REST API - a powerful interface for building e-commerce experiences across multiple stores, all within a single cart and checkout system.

With this API, you can:

  • ๐Ÿ” Search and retrieve live product data
  • ๐Ÿ›’ Build carts with products from different retailers
  • ๐Ÿ’ณ Checkout and pay seamlessly and securely

Whether youโ€™re working with structured product data or unstructured media like images and video, the Diddo API helps you turn customer intent into purchases.


๐Ÿงฑ What You Can Build

Diddo is built to power a wide range of e-commerce experiences:

  • Cross-store carts and universal checkout flows
  • Curated product carousels by player, team, brand, or tag
  • In-stream product overlays linked to short-form video
  • Multi-brand storefronts, pop-ups, and drop campaigns
  • Flexible integration with your payment stackโ€”or ours

๐Ÿ“š Key Resources

Everything you need to get started quickly and confidently:

๐Ÿ” Authentication ๐Ÿ”—

Learn how to authenticate API requests using tokens.

๐Ÿ“– API Reference ๐Ÿ”—

Browse all endpoints, parameters, and response formats.

๐Ÿงช Sandbox Examples ๐Ÿ”—

Test real code in live examples with mock storefronts.


๐Ÿงญ Guides

Step-by-step guides for common workflows, including:


โ“ FAQ ๐Ÿ”—

Answers to common questions, from setup to scaling.


๐Ÿง  Before You Start

A quick checklist before you dive in:

  • Ensure youโ€™ve retrieved an API token
  • Get to know your vertical (e.g. Sports, Fashion, Creator) - available filters and endpoints may vary
  • Let us know if youโ€™re building a custom storefront, video shopping experience, or using a third-party payment gateway - weโ€™ll help you get set up

โœ‰๏ธ Need Help?

Weโ€™re here to support you. Contact your integration lead or email support@shopdiddo.com for assistance.


๐Ÿ‘‰ Next: Authentication & API Keys