Also · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the ALSO Storefront JSON API

7 actions 7 updates update extends openapi/also-storefront-json-openapi.yml

Derived by API Evangelist Built from the contracts Also publishes. Also did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-agentic-accessx-apievangelist-notex-apievangelist-providerx-apievangelist-enrichedx-apievangelist-contract-surfaces

Targets 7

$.info

$.paths['/products.json'].get

$.paths['/products/{handle}.json'].get

$.paths['/collections.json'].get

$.paths['/collections/{handle}/products.json'].get

$.paths['/cart.js'].get

$.paths['/search'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the ALSO Storefront JSON API
  version: 1.0.0
extends: openapi/also-storefront-json-openapi.yml
x-generated: '2026-08-02'
x-method: generated
actions:
- target: $.info
  update:
    x-apievangelist-provider: also
    x-apievangelist-enriched: '2026-08-02'
    x-apievangelist-contract-surfaces:
      graphql: graphql/also-storefront-2026-07.graphql
      mcp: mcp/also-mcp.yml
      crosswalk: mcp/also-tool-crosswalk.yml
    x-apievangelist-note: ALSO publishes no OpenAPI. This description was generated
      by API Evangelist from the endpoints ALSO advertises to agents in its own
      /agents.md, with every path probed live.
- target: $.paths['/products.json'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 3600}
- target: $.paths['/products/{handle}.json'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 3600}
- target: $.paths['/collections.json'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 3600}
- target: $.paths['/collections/{handle}/products.json'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 3600}
- target: $.paths['/cart.js'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 900}
    x-apievangelist-note: Session-scoped; returns the cart bound to the caller's cookie.
- target: $.paths['/search'].get
  update:
    x-agentic-access:
      action-class: connected
      consequence: read
      token: {ttl-max: 3600}
    x-apievangelist-note: Returns HTML, not JSON. Prefer the GraphQL `search` or
      `predictiveSearch` query for machine consumption.

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
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 overlay

curl "https://apis.io/api/v1/overlays/also-storefront-json-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?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.

GitHub Google LinkedIn

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