For providers / API servicesDocs menu

API services

Publish a REST API to the marketplace. Set per-endpoint pricing, optionally inject upstream auth, optionally offer a free tier.

Create the service

From your dashboard, click New service. You'll set:

  • Name: human-friendly (e.g. "Currency Exchange Rates")
  • Slug: URL identifier (e.g. exchange-rates) - this becomes the path under proxy.apihub.io/{slug}
  • Description: one-line pitch that shows on marketplace cards
  • Category: ai, data, search, finance, media, infra, communication, content, travel
  • Base URL: where your API lives. The proxy forwards {base_url}{endpoint_path} for each request
  • OpenAPI spec URL (optional): link to your spec for richer schema parsing

New services start in draft status. Add endpoints, test, then activate.

Add endpoints with pricing

Each endpoint is a (method, path) pair with a price in microdollars. Open your service's detail page in the dashboard, then Add endpoint:

  • Method: GET, POST, PUT, DELETE
  • Path: relative to base URL (e.g. /latest/USD, /v1/translate)
  • Description: shows in agent search results and MCP tool descriptions
  • Price per request: in microdollars (1 USD = 1,000,000)

Pricing math

  • 100 = $0.0001 per call
  • 500 = $0.0005
  • 1000 = $0.001
  • 10000 = $0.01
  • 100000 = $0.10

Platform commission (default 10%) is deducted at payout time. You get 90% of the listed price.

Configure upstream auth (optional)

If your API requires authentication, you can set a header that the proxy injects on every forwarded request. Agents never see this header; it's your secret with the proxy.

Service config (in dashboard Edit page)
upstream_auth_header: X-API-Key
upstream_auth_value: sk_provider_secret_abc123

When an agent calls proxy.apihub.io/{slug}/v1/foo, the proxy fetches your {base_url}/v1/foo with X-API-Key: sk_provider_secret_abc123 appended.

Why this matters

Your backend can require this header and reject requests that don't have it. That makes APIHub the only path to your API. Direct scrapers without your secret get 401.

Configure a free tier (optional)

Each service supports a free quota: N free calls per agent per month. Common pattern: offer a small free tier as marketing, then charge for serious usage.

Set free_tier_monthly_limit on the service in the dashboard. The proxy tracks per-agent usage in KV and falls through to credits/x402 once exhausted. Free calls show x-apihub-payment-protocol: free_tier in the response headers.

Override commission per service (optional)

The platform default is 10% commission. Per-service overrides are supported via the commission_rate column (admin-set). Reach out via support if you need a custom rate.

Service lifecycle

From the service detail page, the Actions card lets you:

  • Activate: move from draft to active. Service appears in the marketplace.
  • Pause: temporarily hide from marketplace. Existing endpoint calls return 404. Agents who hardcoded the slug will see SERVICE_NOT_FOUND.
  • Delete: permanent removal of the service and all endpoints. Past transaction history is preserved for audit.

Testing your service before activating

Calls to your own service from your own API keys bypass payment (marked provider_test). Use this to verify the upstream forwarding, header injection, and pricing setup before activating.

bash
# even on a draft service, your own keys can call it for testing
curl https://proxy.apihub.io/your-slug/your-endpoint \
  -H "Authorization: Bearer ahk_your_key"

Limits

  • Max active services per provider: 50
  • Endpoints per service: no hard cap, but lists with hundreds become hard to manage
  • Slug uniqueness: globally unique. Pick something specific to your brand.