API & Agent Discovery

This page documents the public content structure of shopify.doran.app. It is intended for crawlers, AI agents, integrations, and developers who need to discover content and understand canonical URL patterns across the site.

Discovery resources

• API Catalog: https://shopify.doran.app/.well-known/api-catalog
• Documentation: https://shopify.doran.app/docs/api
• Homepage: https://shopify.doran.app

Editorial content

Posts

Long-form editorial content is published under /posts/[url]. Posts are statically generated from markdown files in the repository.

• Example post: /posts/best-email-marketing-for-shopify
• Blog index: /blog

Blog category pages

Category archives are published under /blog/[category].

• /blog/shopify-apps
• /blog/shopify-themes
• /blog/ecommerce-knowledge

Author pages

Author profile pages are published under /authors/[username].

• /authors/imlindabui
• /authors/imandrewdoan

Apps and product pages

App and product marketing pages are published under /apps.

• App index: /apps
• /apps/product-reviews
• /apps/product-reviews/demo
• /apps/shoppable-videos
• /apps/shoppable-videos/demo

Company and business pages

The site exposes static company pages for contact, partnership, testimonials, and business information.

• /contact-us
• /partners

Legal and policy pages

Legal and policy information is published as static pages.

• /privacy
• /terms

Catalog contents

The API catalog at /.well-known/api-catalog is a static JSON document generated at build time. It includes public content discovery metadata for posts, categories, authors, app pages, demo pages, company pages, and legal pages.

Canonical URL patterns

• https://shopify.doran.app/posts/<slug>
• https://shopify.doran.app/blog/<category>
• https://shopify.doran.app/authors/<username>
• https://shopify.doran.app/apps/<app-slug>
• https://shopify.doran.app/apps/<app-slug>/demo