Link in Seconds Links API

The Links API from Link in Seconds — 2 operation(s) for links.

GitHub OpenAPI

Operations 2

GET /links/{slug}/analytics Analytics for one link over a UTC window #

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/linkinseconds-com:linkinseconds-com-links-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

linkinseconds-com-links-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Link in Seconds Links API
  version: 1.0.0
  description: 'Upload a file and get a public link. Uploads go straight to storage in three steps: create an upload, PUT the bytes to the signed URL, complete it. The account''s plan limits, file-type checks and moderation apply to every upload. Each API key has a request rate limit in units (analytics calls cost 5, other calls 1): Free 60/minute and 2000/day, paid 300/minute and 20000/day (UTC). Over the limit returns 429 with a Retry-After header; responses carry X-RateLimit-Limit and X-RateLimit-Remaining for the current minute.'
servers:
- url: https://linkinseconds.com/api/v1
security:
- apiKey: []
tags:
- name: Links
paths:
  /links:
    get:
      operationId: listLinks
      summary: List the account's links, newest first
      parameters:
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      responses:
        '200':
          description: Links
          content:
            application/json:
              schema:
                type: object
                properties:
                  links:
                    type: array
                    items:
                      type: object
                      properties:
                        slug:
                          type: string
                        title:
                          type: string
                        url:
                          type: string
                          format: uri
                        kind:
                          type: string
                        size_bytes:
                          type: integer
                        created_at:
                          type: string
                          format: date-time
                        status:
                          type: string
                          enum:
                          - live
                          - review
                          - processing
                          - disabled
        '401':
          description: Missing, invalid or revoked API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
        '429':
          description: 'code rate_limited: over the per-key request limit (scope minute/day/burst/auth) or the hourly upload cap (scope upload_hour). Wait Retry-After seconds, then retry.'
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
      tags:
      - Links
  /links/{slug}/analytics:
    get:
      operationId: getLinkAnalytics
      summary: Analytics for one link over a UTC window
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: range
        in: query
        description: UTC window. Default 30d.
        schema:
          type: string
          enum:
          - 7d
          - 14d
          - 30d
          - 90d
          - all
          default: 30d
      responses:
        '200':
          description: The link and its report
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    link:
                      type: object
                      properties:
                        slug:
                          type: string
                        title:
                          type: string
                        url:
                          type: string
                          format: uri
                        kind:
                          type: string
                - $ref: '#/components/schemas/AnalyticsReport'
        '400':
          description: 'code bad_range: range is not one of 7d, 14d, 30d, 90d, all'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
        '401':
          description: Missing, invalid or revoked API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
        '403':
          description: code banned (account suspended)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
        '404':
          description: 'code not_found: no such link on this account'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
        '429':
          description: 'code rate_limited: over the per-key request limit (scope minute/day/burst/auth) or the hourly upload cap (scope upload_hour). Wait Retry-After seconds, then retry.'
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait before retrying
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  code:
                    type: string
                required:
                - error
      tags:
      - Links
components:
  schemas:
    AnalyticsReport:
      type: object
      description: The same report the dashboard renders. All dates are UTC; range.to is exclusive. Bots and link previews are excluded and counted in totals.botsExcluded. Atypical sessions (bots, email scanners, link previews) are counted in totals.atypical, flagged in recent[].atypical and kept out of every average. Engagement fields come from the viewer's session and are 0 for opens recorded before engagement tracking existed.
      properties:
        range:
          type: object
          properties:
            key:
              type: string
              enum:
              - 7d
              - 14d
              - 30d
              - 90d
              - all
            from:
              type: string
              format: date-time
            to:
              type: string
              format: date-time
            days:
              type: integer
            label:
              type: string
        totals:
          type: object
          properties:
            views:
              type: integer
            uniques:
              type: integer
            sessions:
              type: integer
              description: Opens with engagement data
            avgEngagedMs:
              type: integer
            medianEngagedMs:
              type: integer
            totalEngagedMs:
              type: integer
            completionPct:
              type:
              - number
              - 'null'
              description: Pages reached, media played or scroll depth, by file kind
            downloads:
              type: integer
              description: All-time, not windowed
            qrScans:
              type: integer
            returningPct:
              type: number
            bouncePct:
              type: number
              description: Opens under 5 engaged seconds
            botsExcluded:
              type: integer
            atypical:
              type: integer
              description: 'Sessions by a bot, email scanner or link preview: counted and listed, not in sessions or any average'
        previous:
          type: object
          description: The same width of time before the range
        deltas:
          type: object
          properties:
            views:
              type: object
              properties:
                pct:
                  type:
                  - integer
                  - 'null'
                  description: Signed percent change vs the previous period; null when the previous period was 0
                dir:
                  type: string
                  enum:
                  - up
                  - down
                  - flat
              required:
              - pct
              - dir
            uniques:
              type: object
              properties:
                pct:
                  type:
                  - integer
                  - 'null'
                  description: Signed percent change vs the previous period; null when the previous period was 0
                dir:
                  type: string
                  enum:
                  - up
                  - down
                  - flat
              required:
              - pct
              - dir
            avgEngagedMs:
              type: object
              properties:
                pct:
                  type:
                  - integer
                  - 'null'
                  description: Signed percent change vs the previous period; null when the previous period was 0
                dir:
                  type: string
                  enum:
                  - up
                  - down
                  - flat
              required:
              - pct
              - dir
            downloads:
              type: object
              properties:
                pct:
                  type:
                  - integer
                  - 'null'
                  description: Signed percent change vs the previous period; null when the previous period was 0
                dir:
                  type: string
                  enum:
                  - up
                  - down
                  - flat
              required:
              - pct
              - dir
        granularity:
          type: string
          enum:
          - day
          - week
        series:
          type: array
          items:
            type: object
            properties:
              date:
                type: string
                format: date
              label:
                type: string
              views:
                type: integer
              uniques:
                type: integer
              avgEngagedS:
                type: integer
        breakdowns:
          type: object
          properties:
            countries:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            cities:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            referrers:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            sources:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            devices:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            browsers:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            os:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
            screens:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  count:
                    type: integer
                  pct:
                    type: number
                    description: Share of the total, 0 to 100
                required:
                - key
                - count
                - pct
        timing:
          type: object
          properties:
            byHour:
              type: array
              items:
                type: integer
              minItems: 24
              maxItems: 24
            byWeekday:
              type: array
              items:
                type: integer
              minItems: 7
              maxItems: 7
              description: Sunday first
            heat:
              type: array
              items:
                type: array
                items:
                  type: integer
              description: '[weekday][hour]'
            peakHour:
              type:
              - integer
              - 'null'
            peakWeekday:
              type:
              - integer
              - 'null'
        content:
          type: object
          description: 'kind: pages (PDF), media (video, audio), scroll (pages, images, text) or none. pages carries dropoff {afterPage, lostPct} and media.dropoff {beforePct, lostPct}, null until at least 3 sessions and a loss of 10 points'
        insights:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              label:
                type: string
              value:
                type: string
              detail:
                type: string
              tone:
                type: string
                enum:
                - good
                - neutral
                - warn
        recent:
          type: array
          description: The 25 most recent opens with engagement data
          items:
            type: object
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: API key from /dashboard/api-keys (starts with lis_).
externalDocs:
  url: https://linkinseconds.com/docs/developers