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 |