Counting your links

Your branded short links collection size can be read with a HTTP GET on the count links endpoint https://api.rebrandly.com/v1/links/count.

If you want to get the number of branded short links matching a given set of conditions (e.g. answering how many branded short links have been created with the domain brand.cool?), you can attach filters to your request:

QUERY PARAMETERS

Parameter name

Type

Constraints

Description

favourite

boolean

optional

Filter branded short links depnding on the favourite (loved) property

domain.id

string

optional

Filter branded short links which refer to a specific branded domain id

GETting filtered links collection size
$ curl 'https://api.rebrandly.com/v1/links/count?favourite=false&status=active&domain.id=8f104cc5b6ee4a4ba7897b06ac2ddcfb' \
-H 'apikey: YOUR_API_KEY'
A numeric value is provided back:
{
    "count": 42
}

Handling errors

HTTP Status

Error type

Description

403

403 - Invalid format

Invalid query parameters format. Double check value for property query parameter. Details about validation failure in message field.

404

404 - Not found
with property value "domain.id"

Given domain.id does not correspond to any existing domain


Did this page help you?