Johrh Storefront API

The Storefront API from Johrh — 17 operation(s) for storefront.

Operations 42

GET /robots.txt Robots Txt #
HEAD /robots.txt Robots Txt #
GET /llms.txt Llms Txt #
HEAD /llms.txt Llms Txt #
HEAD /.well-known/{file} Well Known #
GET /.well-known/{file} Well Known #
GET /sitemaps/sitemap_feeds.xml Products Feed #
HEAD /sitemaps/sitemap_feeds.xml Products Feed #
GET /sitemaps/feeds.xml Products Feed #
HEAD /sitemaps/feeds.xml Products Feed #
GET /sitemap_feeds.xml Products Feed #
HEAD /sitemap_feeds.xml Products Feed #
GET /feeds.xml Products Feed #
HEAD /feeds.xml Products Feed #
GET /feeds/product/{feed_map} Products Feed #
HEAD /feeds/product/{feed_map} Products Feed #
HEAD /sitemaps/{map_type}.xml Sitemap Xml #
GET /sitemaps/{map_type}.xml Sitemap Xml #
HEAD /{map_type}.xml Sitemap Xml #
GET /{map_type}.xml Sitemap Xml #
HEAD /feeds/{token}/feed.csv Product Feed V2 #
GET /feeds/{token}/feed.csv Product Feed V2 #
HEAD /feeds/{token}/feed.xml Product Feed V2 #
GET /feeds/{token}/feed.xml Product Feed V2 #
GET /feeds/reviews/google Products Reviews Feed #
HEAD /feeds/reviews/google Products Reviews Feed #
GET /blog/feed.rss Blog Rss Feed #
HEAD /blog/feed.rss Blog Rss Feed #
GET /blog/sitemap.xml Blog Sitemap #
HEAD /blog/sitemap.xml Blog Sitemap #
HEAD /blog/categories/{category_slug}/feed.rss Blog Category Rss Feed #
GET /blog/categories/{category_slug}/feed.rss Blog Category Rss Feed #
GET /brands/sitemap.xml Brands Sitemap #
HEAD /brands/sitemap.xml Brands Sitemap #
GET /blogs List Blogs #
GET /blogs/{slug} Blogs #
GET /pages/{slug} Pages #
GET /faqs Faqs #
GET /shipping-and-payment Shipping Payment #
GET /l/{slug} Product Landing Page #
GET /affiliate-reports/{report_code} Affiliate Reports #
GET /validate Validate Theme #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/johrh:johrh-storefront-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

johrh-storefront-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Vitrin Storefront API
  version: 2026.2.23
tags:
- name: Storefront
paths:
  /robots.txt:
    get:
      tags:
      - Storefront
      summary: Robots Txt
      operationId: robots_txt_robots_txt_head
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - Storefront
      summary: Robots Txt
      operationId: headRobotsTxt
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: robots_txt_robots_txt_head
  /llms.txt:
    get:
      tags:
      - Storefront
      summary: Llms Txt
      operationId: llms_txt_llms_txt_head
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - Storefront
      summary: Llms Txt
      operationId: headLlmsTxt
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: llms_txt_llms_txt_head
  /.well-known/{file}:
    head:
      tags:
      - Storefront
      summary: Well Known
      operationId: well_known__well_known__file__head
      parameters:
      - name: file
        in: path
        required: true
        schema:
          type: string
          title: File
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Well Known
      operationId: getWellKnownByFile
      parameters:
      - name: file
        in: path
        required: true
        schema:
          type: string
          title: File
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: well_known__well_known__file__head
  /sitemaps/sitemap_feeds.xml:
    get:
      tags:
      - Storefront
      summary: Products Feed
      operationId: products_feed_sitemaps_sitemap_feeds_xml_head
      responses:
        '302':
          description: Successful Response
      deprecated: true
    head:
      tags:
      - Storefront
      summary: Products Feed
      operationId: headSitemapsSitemapFeedsXml
      responses:
        '302':
          description: Successful Response
      deprecated: true
      x-operation-id-source: normalized
      x-operation-id-original: products_feed_sitemaps_sitemap_feeds_xml_head
  /sitemaps/feeds.xml:
    get:
      tags:
      - Storefront
      summary: Products Feed
      operationId: products_feed_sitemaps_feeds_xml_head
      responses:
        '302':
          description: Successful Response
      deprecated: true
    head:
      tags:
      - Storefront
      summary: Products Feed
      operationId: headSitemapsFeedsXml
      responses:
        '302':
          description: Successful Response
      deprecated: true
      x-operation-id-source: normalized
      x-operation-id-original: products_feed_sitemaps_feeds_xml_head
  /sitemap_feeds.xml:
    get:
      tags:
      - Storefront
      summary: Products Feed
      operationId: products_feed_sitemap_feeds_xml_head
      responses:
        '302':
          description: Successful Response
      deprecated: true
    head:
      tags:
      - Storefront
      summary: Products Feed
      operationId: headSitemapFeedsXml
      responses:
        '302':
          description: Successful Response
      deprecated: true
      x-operation-id-source: normalized
      x-operation-id-original: products_feed_sitemap_feeds_xml_head
  /feeds.xml:
    get:
      tags:
      - Storefront
      summary: Products Feed
      operationId: products_feed_feeds_xml_head
      responses:
        '302':
          description: Successful Response
      deprecated: true
    head:
      tags:
      - Storefront
      summary: Products Feed
      operationId: headFeedsXml
      responses:
        '302':
          description: Successful Response
      deprecated: true
      x-operation-id-source: normalized
      x-operation-id-original: products_feed_feeds_xml_head
  /feeds/product/{feed_map}:
    get:
      tags:
      - Storefront
      summary: Products Feed
      operationId: products_feed_feeds_product__feed_map__head
      responses:
        '302':
          description: Successful Response
      deprecated: true
    head:
      tags:
      - Storefront
      summary: Products Feed
      operationId: headFeedsProductByFeedMap
      responses:
        '302':
          description: Successful Response
      deprecated: true
      x-operation-id-source: normalized
      x-operation-id-original: products_feed_feeds_product__feed_map__head
  /sitemaps/{map_type}.xml:
    head:
      tags:
      - Storefront
      summary: Sitemap Xml
      operationId: sitemap_xml_sitemaps__map_type__xml_head
      parameters:
      - name: map_type
        in: path
        required: true
        schema:
          anyOf:
          - enum:
            - sitemap
            - products
            - product
            - pages
            - categories
            - index
            - products_reviews
            type: string
          - type: string
          title: Map Type
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Sitemap Xml
      operationId: getSitemaps{mapType}Xml
      parameters:
      - name: map_type
        in: path
        required: true
        schema:
          anyOf:
          - enum:
            - sitemap
            - products
            - product
            - pages
            - categories
            - index
            - products_reviews
            type: string
          - type: string
          title: Map Type
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: sitemap_xml_sitemaps__map_type__xml_head
  /{map_type}.xml:
    head:
      tags:
      - Storefront
      summary: Sitemap Xml
      operationId: sitemap_xml__map_type__xml_head
      parameters:
      - name: map_type
        in: path
        required: true
        schema:
          anyOf:
          - enum:
            - sitemap
            - products
            - product
            - pages
            - categories
            - index
            - products_reviews
            type: string
          - type: string
          title: Map Type
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Sitemap Xml
      operationId: get{mapType}Xml
      parameters:
      - name: map_type
        in: path
        required: true
        schema:
          anyOf:
          - enum:
            - sitemap
            - products
            - product
            - pages
            - categories
            - index
            - products_reviews
            type: string
          - type: string
          title: Map Type
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: sitemap_xml__map_type__xml_head
  /feeds/{token}/feed.csv:
    head:
      tags:
      - Storefront
      summary: Product Feed V2
      description: 'Stream the gzipped product feed (XML, or CSV for OpenAI) from the

        merchant''s own domain.


        Backs the new `product_feeds` system in extension-backend. The token is

        stable per-feed (rotated on regen via S3 key reuse), and the underlying

        object is uploaded with `Content-Encoding: gzip`, so we pass the raw

        bytes through unchanged and mirror the upstream headers so crawlers

        (Meta Catalog, TikTok, Google Merchant Center, OpenAI) decompress correctly.


        HEAD is forwarded upstream as HEAD: crawlers probe it before fetching,

        and we answer with the object''s headers without streaming the body.'
      operationId: product_feed_v2_feeds__token__feed_csv_head
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Product Feed V2
      description: 'Stream the gzipped product feed (XML, or CSV for OpenAI) from the

        merchant''s own domain.


        Backs the new `product_feeds` system in extension-backend. The token is

        stable per-feed (rotated on regen via S3 key reuse), and the underlying

        object is uploaded with `Content-Encoding: gzip`, so we pass the raw

        bytes through unchanged and mirror the upstream headers so crawlers

        (Meta Catalog, TikTok, Google Merchant Center, OpenAI) decompress correctly.


        HEAD is forwarded upstream as HEAD: crawlers probe it before fetching,

        and we answer with the object''s headers without streaming the body.'
      operationId: getFeedsByTokenFeedCsv
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: product_feed_v2_feeds__token__feed_csv_head
  /feeds/{token}/feed.xml:
    head:
      tags:
      - Storefront
      summary: Product Feed V2
      description: 'Stream the gzipped product feed (XML, or CSV for OpenAI) from the

        merchant''s own domain.


        Backs the new `product_feeds` system in extension-backend. The token is

        stable per-feed (rotated on regen via S3 key reuse), and the underlying

        object is uploaded with `Content-Encoding: gzip`, so we pass the raw

        bytes through unchanged and mirror the upstream headers so crawlers

        (Meta Catalog, TikTok, Google Merchant Center, OpenAI) decompress correctly.


        HEAD is forwarded upstream as HEAD: crawlers probe it before fetching,

        and we answer with the object''s headers without streaming the body.'
      operationId: product_feed_v2_feeds__token__feed_xml_head
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Product Feed V2
      description: 'Stream the gzipped product feed (XML, or CSV for OpenAI) from the

        merchant''s own domain.


        Backs the new `product_feeds` system in extension-backend. The token is

        stable per-feed (rotated on regen via S3 key reuse), and the underlying

        object is uploaded with `Content-Encoding: gzip`, so we pass the raw

        bytes through unchanged and mirror the upstream headers so crawlers

        (Meta Catalog, TikTok, Google Merchant Center, OpenAI) decompress correctly.


        HEAD is forwarded upstream as HEAD: crawlers probe it before fetching,

        and we answer with the object''s headers without streaming the body.'
      operationId: getFeedsByTokenFeedXml
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: product_feed_v2_feeds__token__feed_xml_head
  /feeds/reviews/google:
    get:
      tags:
      - Storefront
      summary: Products Reviews Feed
      operationId: products_reviews_feed_feeds_reviews_google_head
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
    head:
      tags:
      - Storefront
      summary: Products Reviews Feed
      operationId: headFeedsReviewsGoogle
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
      x-operation-id-source: normalized
      x-operation-id-original: products_reviews_feed_feeds_reviews_google_head
  /blog/feed.rss:
    get:
      tags:
      - Storefront
      summary: Blog Rss Feed
      operationId: blog_rss_feed_blog_feed_rss_head
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - Storefront
      summary: Blog Rss Feed
      operationId: headBlogFeedRss
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: blog_rss_feed_blog_feed_rss_head
  /blog/sitemap.xml:
    get:
      tags:
      - Storefront
      summary: Blog Sitemap
      operationId: blog_sitemap_blog_sitemap_xml_head
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - Storefront
      summary: Blog Sitemap
      operationId: headBlogSitemapXml
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: blog_sitemap_blog_sitemap_xml_head
  /blog/categories/{category_slug}/feed.rss:
    head:
      tags:
      - Storefront
      summary: Blog Category Rss Feed
      operationId: blog_category_rss_feed_blog_categories__category_slug__feed_rss_head
      parameters:
      - name: category_slug
        in: path
        required: true
        schema:
          type: string
          title: Category Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Storefront
      summary: Blog Category Rss Feed
      operationId: getBlogCategoriesByCategorySlugFeedRss
      parameters:
      - name: category_slug
        in: path
        required: true
        schema:
          type: string
          title: Category Slug
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: blog_category_rss_feed_blog_categories__category_slug__feed_rss_head
  /brands/sitemap.xml:
    get:
      tags:
      - Storefront
      summary: Brands Sitemap
      operationId: brands_sitemap_brands_sitemap_xml_head
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
    head:
      tags:
      - Storefront
      summary: Brands Sitemap
      operationId: headBrandsSitemapXml
      responses:
        '200':
          description: Successful Response
          content:
            application/xml:
              schema:
                type: string
      x-operation-id-source: normalized
      x-operation-id-original: brands_sitemap_brands_sitemap_xml_head
  /blogs:
    get:
      tags:
      - Storefront
      summary: List Blogs
      operationId: list_blogs_blogs_get
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          default: 1
          title: Page
      - name: page_size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 24
          title: Page Size
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by category slug
          title: Category
        description: Filter by category slug
      - name: tags
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Filter by tags slugs (comma-separated)
          title: Tags
        description: Filter by tags slugs (comma-separated)
      - name: ordering
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Ordering
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /blogs/{slug}:
    get:
      tags:
      - Storefront
      summary: Blogs
      operationId: blogs_blogs__slug__get
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /pages/{slug}:
    get:
      tags:
      - Storefront
      summary: Pages
      operationId: pages_pages__slug__get
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /faqs:
    get:
      tags:
      - Storefront
      summary: Faqs
      operationId: faqs_faqs_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
  /shipping-and-payment:
    get:
      tags:
      - Storefront
      summary: Shipping Payment
      operationId: shipping_payment_shipping_and_payment_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
  /l/{slug}:
    get:
      tags:
      - Storefront
      summary: Product Landing Page
      operationId: product_landing_page_l__slug__get
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
          title: Slug
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /affiliate-reports/{report_code}:
    get:
      tags:
      - Storefront
      summary: Affiliate Reports
      operationId: affiliate_reports_affiliate_reports__report_code__get
      parameters:
      - name: report_code
        in: path
        required: true
        schema:
          type: string
          title: Report Code
      - name: date_from
        in: query
        required: false
        schema:
          type: string
          format: date
          title: Date From
      - name: date_to
        in: query
        required: false
        schema:
          type: string
          format: date
          title: Date To
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /validate:
    get:
      tags:
      - Storefront
      summary: Validate Theme
      operationId: validate_theme_validate_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-provenance:
  method: harvested
  publisher: Johrh
  source: https://johrh.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)