List Links

Retrieve a list of links

GET https://api.linquid.io/links

List Links

cURL

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

Parameter	Type	Description
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 100)
campaignId	string	Filter by campaign
search	string	Search in title, shortCode
enabled	boolean	Filter by enabled status
sortBy	string	Sort field (createdAt, clicks, title)
sortOrder	string	asc 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"

Search

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"