Marketplace gateway
Call any Gateway API from the marketplace with your APISwaps key. APISwaps forwards the request to the provider with the provider's own credentials and bills your balance per call — one key, one balance, every API.
Base URL
https://apiswaps.com/api/gw/v1/<listing-slug>/<path>The listing page shows the exact base URL and every endpoint with its price. Query strings and request bodies are passed through unchanged.
Authentication
Send the API token you created in Settings → API Tokens:
Authorization: Bearer sk-as-...The same token also works for the Partner API. Never put provider credentials in your requests — the gateway injects them for you.
Example
curl https://apiswaps.com/api/gw/v1/acme-search/search?q=hello \ -H "Authorization: Bearer sk-as-YOUR_KEY"Billing
- Only 2xx responses are charged, at the price shown on the listing (per request or per 1,000 requests, spread per call).
- 4xx/5xx responses, timeouts and provider outages are free.
- Charges appear on Usage → Marketplace and in your transactions as
Marketplace: <listing>. - Calls are refused with
402when your balance cannot cover one call. Top up on Credits.
Errors
Errors are JSON:
{ "error": { "type": "insufficient_balance", "message": "...", "request_id": "gw_..." } }| Status | type | Meaning |
|---|---|---|
| 401 | unauthorized | Missing or invalid API key |
| 402 | insufficient_balance | Balance cannot cover one call |
| 404 | not_found / endpoint_not_found | Unknown listing or path |
| 413 | payload_too_large | Body over 10 MB |
| 429 | rate_limited | Per-key limit for this listing |
| 502 | upstream_error / unsafe_upstream | Provider unreachable or its address is not allowed |
| 503 | listing_unavailable | Provider configuration incomplete |
| 504 | upstream_timeout | Provider did not answer in time |
Quote the request_id (also sent as the X-Request-Id header) when contacting support.
Limits
Request bodies up to 10 MB, 600 requests per minute per key and listing by default, provider timeout up to 30 seconds. Responses are streamed; redirects from the provider are not followed.