Retrieve multiple links
curl --request GET \
--url https://itlinks.to/v1/links/ \
--header 'Authorization: <api-key>'{
"data": {
"total": 2,
"rows": [
{
"id": 1001,
"name": "Example Link 1",
"domain": "example.com",
"slug": "example-link-1",
"tags": [
"tag1",
"tag2"
],
"rules": [
{
"id": 10001,
"name": "Morning Rule",
"active_from": "2023-01-01",
"active_to": "2023-12-31",
"locations": [
{
"type": "country",
"name": "USA"
}
],
"device_types": [
"Mobile",
"Desktop"
],
"oses": [
"Windows",
"iOS"
],
"week_days": [
"Monday",
"Tuesday",
"Wednesday"
],
"day_time_ranges": [
{
"start": "08:00",
"end": "12:00"
}
],
"url_ratios": [
{
"name": "Primary URL",
"url": "http://example.com/main",
"ratio": 0.8
},
{
"name": "Secondary URL",
"url": "http://example.com/secondary",
"ratio": 0.2
}
],
"created_at": "2023-01-01T00:00:00"
}
]
},
{
"id": 1002,
"name": "Example Link 2",
"domain": "anotherexample.com",
"slug": "example-link-2",
"tags": [
"tag3",
"tag4"
],
"rules": [
{
"id": 10002,
"name": null,
"active_from": "2023-02-01",
"active_to": null,
"locations": [
{
"type": "continent",
"name": "Europe"
}
],
"device_types": [
"Tablet"
],
"oses": [
"Android"
],
"week_days": [
"Thursday",
"Friday"
],
"day_time_ranges": [
{
"start": "17:00",
"end": "21:00"
}
],
"url_ratios": [
{
"name": "Only URL",
"url": "http://example.com/single",
"ratio": 1
}
],
"created_at": "2023-02-01T10:00:00"
}
]
}
]
}
}Authorizations
Response
Total number of links in the result.
The unique identifier of the link.
x >= 1The name of the link.
320The domain associated with the link.
253A URL-friendly identifier for the link.
320A list of tags for categorizing the link.
A list of rules associated with the link.
The unique identifier of the rule.
x >= 1The name of the rule.
320The starting date from which the rule is active.
The ending date until which the rule is active.
A list of locations where the rule applies.
The type of location targeted by the rule.
country, continent The specific location targeted by the rule.
"ISO 3166-1 alpha-3 country code, or one of: ['Africa', 'Antarctica', 'Asia', 'Australia', 'Europe', 'North America', 'Oceania', 'South America']"
The types of devices targeted by the rule.
Desktop, Mobile, Tablet, iPod, SmartTV, Console, Wearable, Embedded, Curl, Bot The operating systems targeted by the rule.
Mac OS, iOS, Android, Windows, Windows Mobile OS The days of the week when the rule is active.
MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY A list of URL ratios defining how different URLs should be distributed.
The actual URL.
The ratio in which this URL should be used.
The name of the URL ratio.
320The meta title for the URL.
320The meta description for the URL.
The media URL for the meta tag.
Information about the associated mobile app.
A list of script IDs associated with the link.
The timestamp when the rule was created.
curl --request GET \
--url https://itlinks.to/v1/links/ \
--header 'Authorization: <api-key>'{
"data": {
"total": 2,
"rows": [
{
"id": 1001,
"name": "Example Link 1",
"domain": "example.com",
"slug": "example-link-1",
"tags": [
"tag1",
"tag2"
],
"rules": [
{
"id": 10001,
"name": "Morning Rule",
"active_from": "2023-01-01",
"active_to": "2023-12-31",
"locations": [
{
"type": "country",
"name": "USA"
}
],
"device_types": [
"Mobile",
"Desktop"
],
"oses": [
"Windows",
"iOS"
],
"week_days": [
"Monday",
"Tuesday",
"Wednesday"
],
"day_time_ranges": [
{
"start": "08:00",
"end": "12:00"
}
],
"url_ratios": [
{
"name": "Primary URL",
"url": "http://example.com/main",
"ratio": 0.8
},
{
"name": "Secondary URL",
"url": "http://example.com/secondary",
"ratio": 0.2
}
],
"created_at": "2023-01-01T00:00:00"
}
]
},
{
"id": 1002,
"name": "Example Link 2",
"domain": "anotherexample.com",
"slug": "example-link-2",
"tags": [
"tag3",
"tag4"
],
"rules": [
{
"id": 10002,
"name": null,
"active_from": "2023-02-01",
"active_to": null,
"locations": [
{
"type": "continent",
"name": "Europe"
}
],
"device_types": [
"Tablet"
],
"oses": [
"Android"
],
"week_days": [
"Thursday",
"Friday"
],
"day_time_ranges": [
{
"start": "17:00",
"end": "21:00"
}
],
"url_ratios": [
{
"name": "Only URL",
"url": "http://example.com/single",
"ratio": 1
}
],
"created_at": "2023-02-01T10:00:00"
}
]
}
]
}
}