API

URL Tags

List of tags

A list of landing page tags that are added to domains and/or links.

Request format

Copy
GET /sites/{site_id}/url-tags

Response example

Copy
[
{
"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

Copy
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

Copy
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

Copy
DELETE /sites/{site_id}/url-tags/{tag_id}

Errors

HTTP codeError message
404Tag not found

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product expert, Alex.

He’ll walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

Request a free demo to see our tools and integrations in action

By clicking this button, you agree to SE Ranking’s Terms of Services and Privacy Policy.