Links API Documentation - ArtistBio.link

Retrieve all

Endpoint

GET https://artistbiolink.com/api/links/

Example

curl --request GET \
--url 'https://artistbiolink.com/api/links/' \
--header 'Authorization: Bearer {api_key}' \

Parameters	Details	Description
page	Optional Integer	The page number that you want results from. Defaults to `1`.
results_per_page	Optional Integer	How many results you want per page. Allowed values are: `10` , `25` , `50` , `100` , `250` , `500`. Defaults to `25`.

Response example

{
    "data": [
        {
            "id": 1,
            "project_id": null,
            "domain_id": 0,
            "type": "link",
            "url": "example",
            "location_url": "https://example.com/",
            "settings": {
                "password": null,
                "sensitive_content": false
            },
            "clicks": 10,
            "order": 0,
            "start_date": null,
            "end_date": null,
            "date": "2020-11-15 12:00:00"
        }
    ],
    "meta": {
        "page": 1,
        "results_per_page": 25,
        "total": 1,
        "total_pages": 1
    },
    "links": {
        "first": "https://artistbiolink.com/api/links?&page=1",
        "last": "https://artistbiolink.com/api/links?&page=1",
        "next": null,
        "prev": null,
        "self": "https://artistbiolink.com/api/links?&page=1"
    }
}

Retrieve one

Endpoint

GET https://artistbiolink.com/api/links/{link_id}

Example

curl --request GET \
--url 'https://artistbiolink.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

Response example

{
    "data": {
        "id": 1,
        "project_id": null,
        "domain_id": 0,
        "type": "link",
        "url": "example",
        "location_url": "https://example.com/",
        "settings": {
            "password": null,
            "sensitive_content": false
        },
        "clicks": 10,
        "order": 0,
        "start_date": null,
        "end_date": null,
        "date": "2020-11-15 12:00:00"
    }
}

Parameters	Details	Description
type	Optional String	`link`
location_url	Required String	The URL of the destination.
url	Optional String	The URL alias of the generated link. Leave empty for a randomly generated one.
domain_id	Optional Integer	-
project_id	Optional Integer	-
pixels_ids	Optional Array Integer	-
schedule	Optional Boolean	-
start_date	Optional String	(schedule=true)
end_date	Optional String	(schedule=true)
clicks_limit	Optional Integer	-
expiration_url	Optional String	-
sensitive_content	Optional Boolean	-
passsword	Optional String	-
targeting_type	Optional String	`country_code` , `device_type` , `browser_language` , `rotation` , `os_name`
targeting_country_code_key[index]	Optional Integer	(targeting_type=country_code)
targeting_country_code_value[index]	Optional String	(targeting_type=country_code)
targeting_device_type_key[index]	Optional Integer	(targeting_type=device_type)
targeting_device_type_value[index]	Optional String	(targeting_type=device_type)
targeting_browser_language_key[index]	Optional Integer	(targeting_type=browser_language)
targeting_browser_language_value[index]	Optional String	(targeting_type=browser_language)
targeting_rotation_key[index]	Optional Integer	(targeting_type=rotation)
targeting_rotation_value[index]	Optional String	(targeting_type=rotation)
targeting_os_name_key[index]	Optional Integer	(targeting_type=os_name)
targeting_os_name_value[index]	Optional String	(targeting_type=os_name)

curl --request POST \
--url 'https://artistbiolink.com/api/links' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'url=example' \
--form 'location_url=https://artistbiolink.com/' \

Response example

{
    "data": {
        "id": 1
    }
}

Update

Endpoint

POST https://artistbiolink.com/api/links/{link_id}

Parameters	Details	Description
location_url	Optional String	The URL of the destination.
url	Optional String	The URL alias of the generated link. Leave empty for a randomly generated one.
domain_id	Optional Integer	-
project_id	Optional Integer	-
pixels_ids	Optional Array Integer	-
schedule	Optional Boolean	-
start_date	Optional String	(schedule=true)
end_date	Optional String	(schedule=true)
clicks_limit	Optional Integer	-
expiration_url	Optional String	-
sensitive_content	Optional Boolean	-
passsword	Optional String	-
targeting_type	Optional String	`country_code` , `device_type` , `browser_language` , `rotation` , `os_name`
targeting_country_code_key[index]	Optional Integer	(targeting_type=country_code)
targeting_country_code_value[index]	Optional String	(targeting_type=country_code)
targeting_device_type_key[index]	Optional Integer	(targeting_type=device_type)
targeting_device_type_value[index]	Optional String	(targeting_type=device_type)
targeting_browser_language_key[index]	Optional Integer	(targeting_type=browser_language)
targeting_browser_language_value[index]	Optional String	(targeting_type=browser_language)
targeting_rotation_key[index]	Optional Integer	(targeting_type=rotation)
targeting_rotation_value[index]	Optional String	(targeting_type=rotation)
targeting_os_name_key[index]	Optional Integer	(targeting_type=os_name)
targeting_os_name_value[index]	Optional String	(targeting_type=os_name)

Example

curl --request POST \
--url 'https://artistbiolink.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'is_enabled=0' \

Response example

{
  "data": {
    "id": 1
  }
}

Delete

Endpoint

DELETE https://artistbiolink.com/api/links/{link_id}

Example

curl --request DELETE \
--url 'https://artistbiolink.com/api/links/{link_id}' \
--header 'Authorization: Bearer {api_key}' \

Links

Retrieve all

Retrieve one

Create

Update

Delete