Proxy Router

The proxy is the core of PincerAPI. It routes your requests to third-party APIs, handling authentication and billing automatically.

Endpoint Format

{METHOD} /api/v1/proxy/{api_id}/{path}

• api_id — The slug of the API (e.g. openweathermap, sendgrid)
• path — The downstream API path (everything after the base URL)

Examples

# OpenWeatherMap
GET /api/v1/proxy/openweathermap/data/2.5/weather?q=London

SendGrid
POST /api/v1/proxy/sendgrid/v3/mail/send

Serper (Google Search)
POST /api/v1/proxy/serper/search

Supported Methods

All standard HTTP methods are supported:

• GET, POST, PUT, PATCH, DELETE

Request Headers

Your request headers are forwarded to the downstream API, with these additions/overrides:

Response

The proxy returns the downstream API's response directly:

• Same status code
• Same response body
• Same content type

Plus these added headers:

Pricing Lanes

How the proxy authenticates depends on the API's pricing lane:

• Instant — PincerAPI uses its own platform key. You pay proxy fee + markup.
• BYOK (Bring Your Own Key) — You store your API key in PincerAPI. You pay proxy fee only.
• Managed — Metered billing. PincerAPI manages the subscription.

Error Codes