Hostingsurge

Hostingsurge Shops API

The Shops API from Hostingsurge — 20 operation(s) for shops.

GitHub OpenAPI

Operations 32

GET /shops The team's shops (builder sites that sell) #
GET /builder/sessions/{sessionId}/shop The shop of a builder site, or null #
POST /builder/sessions/{sessionId}/shop Create the shop of a builder site (or return the one it has): defaults for the… #
GET /shops/{shopId} A shop with its settings and today's counts #
PATCH /shops/{shopId} Change a shop's settings (name, VAT, payments, policies, …) #
DELETE /shops/{shopId} Delete a shop with its products, orders and customers #
GET /shops/{shopId}/products Products (drafts and those on sale; status=all adds archived) #
POST /shops/{shopId}/products Add a product with its variants (on sale unless status draft) #
POST /shops/{shopId}/products/confirm-prices "Check prices before you go live": confirm the AI's prices and put the products… #
POST /shops/{shopId}/products/pending-changes Apply or discard the AI's proposed price changes to a product on sale #
GET /shops/{shopId}/products/{productId} One product #
PATCH /shops/{shopId}/products/{productId} Change a product (variants replace the list; a variant keeps its id and stock… #
DELETE /shops/{shopId}/products/{productId} Delete a product (orders keep their copy) #
GET /shops/{shopId}/inventory Stock of every variant (low = at or under the shop's threshold) #
POST /shops/{shopId}/inventory Set or adjust stock of several variants at once #
GET /shops/{shopId}/collections Collections #
POST /shops/{shopId}/collections Add a collection (manual or by tag) #
PATCH /shops/{shopId}/collections/{collectionId} Change a collection #
DELETE /shops/{shopId}/collections/{collectionId} Delete a collection #
GET /shops/{shopId}/shipping Shipping zones and rates #
PUT /shops/{shopId}/shipping Replace the shipping zones and rates #
GET /shops/{shopId}/discounts Discount codes #
POST /shops/{shopId}/discounts Add a discount code (percent, fixed or free shipping) #
PATCH /shops/{shopId}/discounts/{discountId} Switch a code on or off, or change its end or limit #
DELETE /shops/{shopId}/discounts/{discountId} Delete a discount code #
POST /shops/{shopId}/policies/generate Fill the policies (terms, returns and withdrawal, privacy, delivery) of the… #
GET /shops/{shopId}/orders Orders, newest first (status, q, from, to, limit) #
GET /shops/{shopId}/orders/{orderId} One order with its history #
POST /shops/{shopId}/orders/{orderId}/{action} mark-paid, fulfill (tracking), refund (amount, restock), cancel (restock)… #
GET /shops/{shopId}/customers Customers with their order counts #
POST /shops/{shopId}/stripe/connect Start (or continue) connecting the shop's own Stripe account: a Stripe… #
POST /shops/{shopId}/stripe/refresh Read the connected Stripe account's status again #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-shops-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json
📊
JSONSchema
https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json

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/hostingsurge-com:hostingsurge-com-shops-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.

GitHub Google LinkedIn

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

OpenAPI Specification

hostingsurge-com-shops-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hostingsurge Platform Shops API
  version: 1.0.0
  description: 'Deploy and operate projects on Hostingsurge: Git/upload/Docker/WordPress projects, deployments, logs, environment variables, domains and databases. Errors are {"error":{"code","message","details?"}}.'
servers:
- url: /api/v1
  description: Same origin as the dashboard, e.g. https://hostingsurge.com/api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:


# --- truncated at 32 KB (491 KB total) ---
# Full source: https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-shops-api-openapi.yml