PingNest REST API

Build on top of links & QR codes with a simple JSON API.

Programmatically create short links, generate QR codes and pull analytics into your own dashboards, CRMs or internal tools.

Base URL https://api.pingnest.com/v1

Authentication

Use your secret API key in the Authorization header:

Authorization: Bearer pn_sk_XXXX

Manage API keys

Production Sandbox (coming soon)

Core endpoints

All responses are JSON

POST /v1/linksLinks

Create

Create a new short link with optional expiry, password and metadata.

GET /v1/links/{id}Links

Retrieve

Fetch full details for a single short link by ID or slug.

GET /v1/linksLinks

List

List all links in a workspace with filtering and pagination.

POST /v1/qr-codesQR Codes

Create QR

Generate a QR code image for an existing link or a raw URL.

GET /v1/analytics/links/{id}Analytics

Stats

Retrieve clicks by country, device and referrer for a specific link.

Example: create a short link

Using curl

curl -X POST https://api.pingnest.com/v1/links \
  -H "Authorization: Bearer pn_sk_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourlongurl.com/blog/summer-campaign",
    "slug": "summer-24",
    "workspace_id": "ws_123",
    "expires_at": null,
    "password": null
  }'

For full schema details, error codes and pagination, see the in-app API reference under Settings → Developers.