tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Links

Get a short link

GET
/v1/links/{id}

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

The link.

application/json
  1. response
id*string
Formatuuid
profile_id*string
Formatuuid
code*string

The part after tbr.ink/: 6 random characters, or the alias (Pro and Agency).

short_url*string

The link to share, e.g. https://tbr.ink/aB3x9K.

url*string

Where the link leads; can be changed.

title*string|null
status*string

blocked: by Tebar for breaking the rules.

Value in"active""disabled""blocked"
clicks*integer

Once per visitor per link per hour; bots left out.

unique_visitors*integer

Each day's distinct visitors, added up.

bot_visits*integer

Link previews and crawlers, not counted as clicks.

last_clicked_at*|null
created_at*string
Formatdate-time
updated_at*string
Formatdate-time
Example Request
curl -X GET 'https://api.tebar.app/v1/links/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",
  "code": "string",
  "short_url": "string",
  "url": "string",
  "title": "string",
  "status": "active",
  "clicks": 0,
  "unique_visitors": 0,
  "bot_visits": 0,
  "last_clicked_at": "2019-08-24T14:15:22Z",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}