Skip to main content
GET
https://api.linquid.io
/
links
List Links
curl --request GET \
  --url https://api.linquid.io/links \
  --header 'Authorization: Bearer <token>'

​
List Links

Retrieve a paginated list of links in your workspace.

​
Request

curl https://api.linquid.io/links \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Query Parameters

ParameterTypeDescription
pagenumberPage number (default: 1)
limitnumberItems per page (default: 20, max: 100)
campaignIdstringFilter by campaign
searchstringSearch in title, shortCode
enabledbooleanFilter by enabled status
sortBystringSort field (createdAt, clicks, title)
sortOrderstringasc or desc

​
Response

{
  "success": true,
  "data": [
    {
      "id": "link_abc123",
      "shortCode": "promo2024",
      "shortUrl": "https://linqu.id/promo2024",
      "destinationUrl": "https://example.com/landing",
      "title": "Black Friday Promo",
      "campaignId": "campaign_xyz",
      "enabled": true,
      "clicks": 1234,
      "uniqueClicks": 890,
      "conversions": 45,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

​
Examples

​
Filter by Campaign

curl "https://api.linquid.io/links?campaignId=campaign_xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://api.linquid.io/links?search=promo" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Sort by Clicks

curl "https://api.linquid.io/links?sortBy=clicks&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_API_KEY"