Spindl Short Links API

Redirect links mapping a Spindl link to a destination URL.

Operations 2

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/spindl-short-links-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

spindl-short-links-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Spindl Server-to-Server Events Short Links API
  version: v1
  description: Spindl's Server-to-Server API provides access to campaign and attribution management, short (redirect) links, server-side custom event ingestion, and daily data exports for Web3 growth analytics and onchain attribution. This OpenAPI description was generated by the API Evangelist enrichment pipeline from Spindl's published API reference documentation; endpoints, methods, parameters, and example payloads are transcribed from docs.spindl.xyz.
  contact:
    name: Spindl
    email: contact@spindl.xyz
    url: https://docs.spindl.xyz/spindl/techncial/api.md
  license:
    name: Proprietary
servers:
- url: https://api.spindl.xyz/v1
  description: Spindl management API (short links, attribution management)
security:
- ApiKeyAuth: []
tags:
- name: Short Links
  description: Redirect links mapping a Spindl link to a destination URL.
paths:
  /links:
    get:
      operationId: listLinks
      summary: Get all links for your organization
      description: Returns all short (redirect) links for your organization, sorted by the time they were created, descending.
      tags:
      - Short Links
      security:
      - ApiKeyAuth: []
      responses:
        '200':
          description: A list of short links.
          content:
            application/json:
              schema:
                type: object
                properties:
                  links:
                    type: array
                    items:
                      $ref: '#/components/schemas/Link'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      operationId: createLink
      summary: Create a link
      description: Create a new short link with Spindl tracking.
      tags:
      - Short Links
      security:
      - ApiKeyAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - url
              properties:
                name:
                  type: string
                  description: The internal name of the link. Names need not be unique; descriptive names are recommended (e.g. "Winter Campaign - Twitter Post 1").
                url:
                  type: string
                  format: uri
                  description: The URL to redirect to (typically where your app lives).
            example:
              name: Winter Campaign - Twitter Post 1
              url: https://demo.spindl.xyz/
      responses:
        '200':
          description: The created short link.
          content:
            application/json:
              schema:
                type: object
                properties:
                  link:
                    $ref: '#/components/schemas/Link'
        '400':
          description: Incorrect or incomplete request (e.g. a required parameter was omitted).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        statusCode:
          type: integer
          example: 404
        message:
          type: string
          example: link not found
    Link:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: dfec5988-5108-465c-be87-ce42039f572e
        name:
          type: string
          example: Spindl Campaign - 2022 - Twitter
        link:
          type: string
          format: uri
          example: https://spindl.link/abcd
        redirectUrl:
          type: string
          format: uri
          example: https://demo.spindl.xyz/
        createdAt:
          type: string
          format: date-time
        totalVisits:
          type: integer
        latestVisit:
          type:
          - string
          - 'null'
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Server-to-Server API key generated on the Settings page in the Spindl app (https://app.spindl.xyz/settings). Distinct from the client-side SDK key.
x-generated: '2026-07-21'
x-method: generated
x-source: https://docs.spindl.xyz/spindl/techncial/api.md