List your links

GET /api/v1/links returns your links, newest first, with their URLs and status.

GET/api/v1/linksAPI key required

Returns the links on your account, newest first. Useful to find a link you published earlier or check its status.

Query parameters

limitinteger
How many links to return, 1 to 100. Default 20.
curl "https://linkinseconds.com/api/v1/links?limit=5" \
  -H "Authorization: Bearer $LIS_API_KEY"
200 OK
{
  "links": [
    {
      "slug": "report-x7",
      "title": "report",
      "url": "https://linkinseconds.com/p/report-x7",
      "kind": "pdf",
      "size_bytes": 482113,
      "created_at": "2026-10-04T09:12:44.120Z",
      "status": "live"
    }
  ]
}

Status values#

statusMeaning
liveAnyone with the link can open it.
reviewHeld by the safety scan until a person checks it. Not public yet.
processingA video still being scanned. Goes live shortly.
disabledYou switched the link off in its settings.

Album and website links are not included. To change a link's settings or delete it, use the dashboard.

PreviousUpload a fileNext Analytics

Last updated 4 October 2026. Something unclear or missing? Tell us.