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

NameDescription
idTag ID
nameTag name
urlList of links the tag is added to
domainList 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

NameRequiredDescription
site_idYesWebsite ID
nameYesName
urlsNoList of links the tag is added to
domainsNoList 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 codeError message
404Tag not found