API Description
URL Tags
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
Response example
[
{
"id": "51",
"name": "tag1",
"url": [ "https://test.com" ],
"domain": [ "www.flotenk.com", "google.com" ],
},
...
]
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 |
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 |