API-ready link infrastructure for apps, bots, and automations.

    1get gives developers one external surface for branded short links, QR generation, privacy-first analytics, and audit-friendly operations without reusing browser-only dashboard APIs.

    Bearer API keys
    One-call link + QR
    Privacy-first analytics
    Audit-ready mutations
    One endpoint can return the short URL and default QR in the same response.
    Human admins use dashboard auth; third-party apps use scoped Bearer keys.
    Successful shorten + QR generation counts as one API call, not two.
    Enterprise lanes expand into webhooks, higher throughput, and richer QR control.
    Integration console
    json
    Request
    POST /api/v1/links/shorten
    Authorization: Bearer 1g_live_...
    Idempotency-Key: 6dbf664d-...
    
    {
      "original_url": "https://acme.ai/workflows/agent-invite/42",
      "custom_slug": "agent-launch",
      "qr": { "include": true, "format": "SVG" }
    }
    Response
    {
      "data": {
        "short_url": "https://1get.site/agent-launch",
        "qr_code": { "url": "https://1get.site/api/media/qr/..." },
        "status": "ACTIVE"
      }
    }
    Auth split

    Bearer keys for external systems.

    QR included

    Basic plans can receive a default QR in the shorten response.

    Usage metering

    Quota and rate limits stay plan-aware from first integration.

    Audit context

    API key lifecycle and link mutations belong in one accountable trail.

    Built for real product surfaces, not just manual dashboard actions

    Use this page to see where 1get belongs in application backends, agents, automations, and internal tooling before moving into full API documentation.

    Applications

    Shorten outbound product links, activation flows, invites, transactional messages, and customer-share surfaces without pushing link creation through browser sessions.

    Typical flow

    App backend -> 1get API -> short URL + QR -> customer surface

    Agents

    Let AI agents create stable links for generated assets, knowledge packets, campaign outputs, or multi-step workflows while keeping each mutation attributable.

    Typical flow

    Agent job -> idempotent shorten -> auditable automation log

    Automations

    Use server-to-server requests in Zapier-style flows, growth jobs, queue workers, and partner automations without relying on human dashboard state.

    Typical flow

    Queue / cron / webhook worker -> scoped key -> machine auth

    Internal tools

    Give ops, support, and sales tooling a central short-link service with rate limits, org ownership, and usage visibility that survives team changes.

    Typical flow

    Internal admin tool -> org-scoped key -> managed link infra

    Separate dashboard auth from the public developer API

    The external developer contract is versioned, API-key authenticated, and stable for third-party applications. The dashboard can keep its session-cookie behavior without becoming the public API.

    Dashboard auth
    Human administrators

    Sign in to manage billing, teams, and API access.

    Create or rotate scoped API keys from the dashboard.

    See the plaintext key once, then store it in your own secret manager.

    Machine auth
    Third-party apps

    Send Authorization: Bearer <api_key> on each external request.

    Resolve organization, scopes, and plan entitlements without browser cookies.

    Run each request as an API principal bound to the subscribed organization.

    Never treat an API key like a browser cookie.

    Keys resolve organization ownership, scopes, and plan features. They are visible once, stored as hashes, and never carry client-supplied organization context.

    Likely route surface
    /api/v1/*
    MVP
    POST /api/v1/links/shorten
    GET /api/v1/links/:id
    GET /api/v1/links/:id/qr
    GET /api/v1/usage
    Phase 2
    PATCH /api/v1/links/:id
    DELETE /api/v1/links/:id
    POST /api/v1/links/batch-shorten
    GET /api/v1/analytics/links/:id
    Enterprise controls
    POST /api/v1/webhooks/test
    GET /api/v1/webhooks
    POST /api/v1/qr/customize
    Primary endpoint

    POST /api/v1/links/shorten is the main onboarding path.

    QR support

    Return default QR output on create, then unlock richer controls on higher tiers.

    Usage visibility

    Expose GET /api/v1/usage so customers can understand quota and rate behavior.

    Show the API contract in real code, not brochure abstractions

    Help technical buyers and AI systems understand the request shape, auth model, idempotency flow, QR response contract, and likely implementation path in minutes.

    Client examples
    curl -X POST https://1get.site/api/v1/links/shorten \
      -H "Authorization: Bearer 1g_live_xxxxx" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: 6dbf664d-243e-4e38-8cb2-1a9640f1a1c4" \
      -d '{
        "original_url": "https://acme.ai/workflows/agent-invite/42",
        "custom_slug": "agent-launch",
        "utm_source": "copilot",
        "utm_medium": "api",
        "qr": {
          "include": true,
          "format": "PNG",
          "size": 256
        }
      }'
    Example response
    json
    {
      "data": {
        "id": "lnk_7z1f2",
        "slug": "agent-launch",
        "short_url": "https://1get.site/agent-launch",
        "original_url": "https://acme.ai/workflows/agent-invite/42",
        "status": "ACTIVE",
        "created_at": "2026-04-06T09:30:00.000Z",
        "qr_code": {
          "id": "qr_8ne4c",
          "url": "https://1get.site/api/media/qr/qr_8ne4c.png",
          "format": "PNG",
          "size": 256
        }
      }
    }
    Contract notes

    One write path returns the short URL and default QR together.

    Successful shorten requests meter one API call even when QR is included.

    Key visibility is one-time at creation; the platform stores only hashed key material.

    Privacy, auditability, and operational discipline are central to the API story

    1get is not a thin wrapper around dashboard routes. Security, privacy posture, and accountability belong in the same operational layer as the API itself.

    Redirect performance

    Built around a fast redirect path so the developer API can support production usage instead of acting like an afterthought.

    <50ms p99 target positioning
    Privacy-first analytics

    Useful link analytics without leaning on raw-IP retention as the default operating model.

    Cleaner analytics posture
    Audit visibility

    API key lifecycle events and API-created link mutations belong in the same accountable operational trail.

    Create, rotate, revoke, mutate
    Secret hygiene

    Keys are shown once, stored as hashes, and resolved to organization ownership instead of being treated as loose personal browser tokens.

    Hash-only storage

    Start with a narrow API lane, then expand into webhooks and broader volume

    The plan ladder climbs from evaluation to production: Basic handles shorten-plus-QR, Business opens broader reads and management operations, and Enterprise adds webhook-heavy, higher-volume control.

    Free
    none
    0 keys
    0 API calls / month
    No API traffic
    Dashboard-only QR evaluation

    Use it to evaluate the product before machine access matters.

    Basic
    shorten
    2 active keys
    10,000 API calls / month
    60 shorten requests / minute
    Default QR in API responses

    Enough for smaller SaaS products, CRMs, no-code tools, and first production automations.

    Business
    full
    10 active keys
    200,000 API calls / month
    300 shorten requests / minute
    Richer QR controls + batch ops

    Move from simple shortening to production integrations, analytics reads, and team-scale automation.

    Enterprise
    FULL + WEBHOOKS
    50+ keys
    2,000,000+ / month
    1,500 requests / minute or custom
    Full QR options + webhooks

    Where partner apps, multi-team operations, and webhook-heavy flows belong.

    Rate-limit posture
    Plan-aware traffic control
    POST /api/v1/links/shorten
    Basic: 60 / min
    Business: 300 / min
    Enterprise: 1,500 / min or custom
    GET /api/v1/usage
    Basic: 30 / min
    Business: 120 / min
    Enterprise: 300 / min
    POST /api/v1/links/batch-shorten
    Basic: not available
    Business: 10 / min
    Enterprise: 60 / min
    Next step

    Start with one scoped key, then expand into more active API lanes.

    Start with a scoped key and one shorten endpoint, then expand into richer management routes, analytics reads, or Enterprise webhook controls when the integration grows up.