URL Tags API
List of tags
A list of landing page tags that are added to domains and/or links.
Request format
GET /sites/{site_id}/url-tags
Request parameters
Name | Description |
id | Tag ID |
name | Tag name |
url | List of links the tag is added to |
domain | List of domains the tag is added to |
Result
If successful, the server returns a list of tags that are added to domains and/or links.
Response example
[
“id”: “51”,
“name”: “tag1”,
“url”: [
“https://test.com”
],
“domain”: [
“www.flotenk.com”,
“google.com”
],
…
]
Adding a tag
The method adds a tag to the site and attaches it to a link and/or domain, if such were transferred. You can add a maximum of 20 tags to one site.
Request format
POST /sites/{site_id}/url-tags
{
“name”: 1,
“urls” : [“http://url.com/path”],
“domains”: [“test.com”],
}
Request parameters
Name | Required | Description |
site_id | Yes | Website ID |
name | Yes | Name |
urls | No | List of links the tag is added to |
domains | No | List of domains the tag is added to |
Result
If successful, the server returns the 200 HTTP code and {tag_id: 1}.
Changing a tag
Adding tags to a domain and/or link. The tags will be added to all the links and domains submitted in the request. All previously added tags will be removed for these links and domains.
Request format
PUT /sites/{site_id}/url-tags
{
“tag_ids” : [],
“urls”: [],
“domains”: []
}
Result
If successful, the server returns the 204 HTTP code.
Deleting a tag
Request format
DELETE /sites/{site_id}/url-tags/{tag_id}
Errors
HTTP code | Error message |
404 | Tag not found |