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

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

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