Smart Links

Get a link

One link with its plan's name loaded. A link of another project is 404 RESOURCE_NOT_FOUND.

Three fields that are easy to misread

urls.bot is null without a bot. The deep link exists only while the project runs a bot that hands out start links; the web address and the embed page are always there.

code never changes, slug may. Share urls.web where the slug is fine to change later; print urls.bot or a QR of urls.web and rely on the code, which survives every rename because the slug's redirect runs through the portal, where the code takes over.

clicks.total is one per visitor address per hour. A creator reading their own page a dozen times adds one, and no analytics cookie is set on a stranger.

get/v1/projects/{project}/links/{smartLink}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/links/{smartLink}
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

smartLinkstring uuid required

The link, resolved within the project by the route binder.

Response

The link with its three addresses.

Example response

{
  "data": {
    "id": "1e2a4c6b-3d5f-4a7b-9c1d-2e3f4a5b6c7d",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "name": "YouTube description",
    "slug": "youtube",
    "code": "TUBE234",
    "destination": {
      "type": "plan",
      "plan_id": "0c9d8e7f-6a5b-4c3d-8e2f-1a2b3c4d5e6f",
      "plan_name": "Premium"
    },
    "urls": {
      "web": "https://my.subscriby.net/research-premium/go/youtube",
      "bot": "https://t.me/ResearchPremiumBot?start=via_TUBE234",
      "embed": "https://my.subscriby.net/research-premium/embed/plans?via=TUBE234"
    },
    "state": "live",
    "clicks": {
      "total": 42,
      "last_at": "2026-10-10T08:00:00+00:00"
    },
    "created_at": "2026-10-01T09:00:00+00:00",
    "updated_at": "2026-10-10T08:00:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.