{
  "openapi": "3.1.0",
  "info": {
    "title": "App Store API — fetcher.sh",
    "version": "1.0.0",
    "summary": "9 pay-per-call App Store endpoints.",
    "description": "Web data for agents and code: **9 App Store endpoints**, priced **$0.003 per call** in USDC on Base, Monad or Solana. No accounts, no OAuth, no subscriptions — you only pay for calls you make.\n\nEvery endpoint is a `GET` returning the same envelope, where the HTTP status mirrors `status`:\n\n```json\n{ \"status\": 200, \"message\": \"ok\", \"data\": { } }\n```\n\n## Two ways to pay\n\n**1. Prepaid credits (simplest for code).** Top up once at [https://appstore.fetcher.sh/topup](https://appstore.fetcher.sh/topup), then send your key on every request:\n\n```bash\ncurl -H \"Authorization: Bearer bby_live_...\" \"https://appstore.fetcher.sh/api/apps?term=meditation\"\n```\n\n**2. x402 per call (for autonomous agents).** Call without payment and you get `402` with machine-readable requirements in the `payment-required` header — one entry per supported network, so pay from whichever of Base, Monad or Solana you hold USDC on. Sign the authorization, retry with it, and the data comes back. Gas is sponsored, so the wallet needs no native token — libraries like `@x402/fetch` do the whole loop for you.\n\n## Errors\n\n`400` invalid or missing parameter (the message names it) · `401` unknown or revoked key · `402` payment required, or `topup_required` when a balance is exhausted · `404` not a priced endpoint · `502` upstream failure. There are no rate limits; your balance is the only limit. Settlement happens before delivery, so failed upstream calls are not refunded.\n\n## Also available\n\n[MCP server](https://appstore.fetcher.sh/#mcp) for Claude, Cursor and other MCP clients · [/skill.md](https://appstore.fetcher.sh/skill.md) agent setup instructions · [/llms.txt](https://appstore.fetcher.sh/llms.txt) condensed catalog · [/topup](https://appstore.fetcher.sh/topup) create or recharge a key.",
    "x-guidance": "App Store is a web-data gateway: 9 read-only endpoints (App Store). Every endpoint is a GET request that returns the same JSON envelope: { status, message, data }, where the HTTP status mirrors the status field. Pricing is per call, $0.003 in USDC. There are no plans, subscriptions, or rate limits — your balance is the only limit. Payable on Base, Monad or Solana: every 402 lists one accepts entry per network (eip155:8453, eip155:143, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), each with its own USDC asset and payTo address, so pick the one matching a chain you hold USDC on. Base (eip155:8453) is always first. Two ways to pay. (1) x402 per call: request the endpoint, receive a 402 with machine-readable payment requirements, sign the USDC transfer authorization for your chosen network, and retry with the signed payload. Gas is sponsored by the facilitator, so the wallet needs no native token. (2) Prepaid credits: POST /api/credits/topup?amount=<usd> once (minimum $1, itself x402-paid) to receive a bby_live_ API key, then send it as `Authorization: Bearer <key>` on any endpoint — no signing and no chain round trip per call, which is much faster for high request volumes. GET /api/credits/balance returns the remaining balance for a key. Substitute path parameters marked {param}. Missing or invalid parameters return a descriptive 400. Settlement happens before delivery, so failed upstream calls are not refunded. Full agent setup instructions: /skill.md. Condensed catalog for LLMs: /llms.txt.",
    "contact": {
      "email": "info@fetcher.sh"
    }
  },
  "servers": [
    {
      "url": "https://appstore.fetcher.sh",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "App Store",
      "description": "Apple App Store app and bundle lookups, reviews, similar apps, and developer catalogs."
    }
  ],
  "components": {
    "schemas": {
      "Envelope": {
        "type": "object",
        "description": "Every response uses this envelope; the HTTP status mirrors `status`.",
        "properties": {
          "status": {
            "type": "integer",
            "description": "HTTP status code, mirrored in the body."
          },
          "message": {
            "type": "string",
            "description": "\"ok\" on success, otherwise the error reason."
          },
          "data": {
            "type": [
              "object",
              "array",
              "null"
            ],
            "description": "Upstream payload; null on errors."
          }
        },
        "required": [
          "status",
          "message",
          "data"
        ]
      }
    }
  },
  "paths": {
    "/api/apps": {
      "get": {
        "operationId": "appstoreApps",
        "summary": "App Store — Apps",
        "description": "Apps from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "term",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/apps/{appId}": {
      "get": {
        "operationId": "appstoreAppsByAppId",
        "summary": "App Store — Apps",
        "description": "Apps from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "appId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/apps/{appId}/reviews": {
      "get": {
        "operationId": "appstoreAppsByAppIdReviews",
        "summary": "App Store — Apps reviews",
        "description": "Apps reviews from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "appId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "helpful"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/apps/{appId}/similar": {
      "get": {
        "operationId": "appstoreAppsByAppIdSimilar",
        "summary": "App Store — Apps similar",
        "description": "Apps similar from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "appId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/bundles": {
      "get": {
        "operationId": "appstoreBundles",
        "summary": "App Store — Bundles",
        "description": "Bundles from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "term",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/bundles/{bundleId}": {
      "get": {
        "operationId": "appstoreBundlesByBundleId",
        "summary": "App Store — Bundles",
        "description": "Bundles from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "bundleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/bundles/{bundleId}/reviews": {
      "get": {
        "operationId": "appstoreBundlesByBundleIdReviews",
        "summary": "App Store — Bundles reviews",
        "description": "Bundles reviews from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "bundleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "recent",
                "helpful"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/bundles/{bundleId}/similar": {
      "get": {
        "operationId": "appstoreBundlesByBundleIdSimilar",
        "summary": "App Store — Bundles similar",
        "description": "Bundles similar from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "bundleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    },
    "/api/developers/{developerId}": {
      "get": {
        "operationId": "appstoreDevelopersByDeveloperId",
        "summary": "App Store — Developers",
        "description": "Developers from App Store. Returns the standard { status, message, data } envelope. $0.003 per call, payable with x402 (USDC on Base, Monad or Solana) or a prepaid credits API key.",
        "tags": [
          "App Store"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.003000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "parameters": [
          {
            "name": "developerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success — upstream payload in `data`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid parameter.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          },
          "502": {
            "description": "Upstream error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          }
        }
      }
    }
  }
}