Link in Seconds Analytics API
The Analytics API from Link in Seconds — 1 operation(s) for analytics.
The Analytics API from Link in Seconds — 1 operation(s) for analytics.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/linkinseconds-com:linkinseconds-com-analytics-api"
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.
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: 3.2.0
info:
title: Link in Seconds Analytics 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: Analytics
paths:
/analytics:
get:
operationId: getAccountAnalytics
summary: Analytics across every link on the account over a UTC window
parameters:
- name: range
in: query
description: UTC window. Default 30d.
schema:
type: string
enum:
- 7d
- 14d
- 30d
- 90d
- all
default: 30d
responses:
'200':
description: The account report with its top links and file-kind mix
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/AnalyticsReport'
- type: object
properties:
top_links:
type: array
maxItems: 25
items:
$ref: '#/components/schemas/LinkSummary'
mix:
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
all_time:
type: object
properties:
views:
type: integer
downloads:
type: integer
links:
type: integer
'400':
description: code bad_range
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
'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:
- Analytics
components:
schemas:
LinkSummary:
type: object
properties:
id:
type: string
slug:
type: string
title:
type: string
kind:
type: string
views:
type: integer
uniques:
type: integer
avgEngagedMs:
type: integer
completionPct:
type:
- number
- 'null'
downloads:
type: integer
spark:
type: array
items:
type: integer
description: Daily views, oldest first, up to 30
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