[GET] Get tags

Modified on Tue, 11 Feb at 3:52 AM

https://api.s7risk.com

The Incident API provides well constructed high-quality, highly-tailored and scalable threat intelligence data.

`GET /tags`Get tags

This endpoint gets all available tags. The tags returned can be filtered in scope by adding a search parameter to your request.

HTTP Request

curl -X GET 'https://api.s7risk.com/tags' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  -d 'search=terr' \
  -d 'sort=desc' \
  -d 'page=2' \
  -d 'pageSize=30' \
  --compressed

Headers

Name	Type	Required	Description
`Authorization`	string	✔️	Your authentication token (see the Auth API section for more information)

Query Parameters

Name	Type	Description
`search`	string	Search using the given search term
`sort`	string	Sort the results by the given properties. Available options `asc` or `desc`. If no sort order is specified then results are sorted by their popularity.
`page`	int	A paginated result set. Defaults to `1`
`pageSize`	int	A limited result set. Defaults to `100`

HTTP Response

{
    "data": [
        {
            "name": "electricity",
            "slug": "electricity",
            "counts": {
                "uses": 985
            }
        },
        {
            "name": "climateprotest",
            "slug": "climateprotest",
            "counts": {
                "uses": 312
            }
        }
    ]
}

Success

Code	Status	Description
200	Success	Returns a body containing all valid tags

Errors

Code	Status	Description
401	Unauthorized	Expired or Invalid Authentication token
422	Unprocessable Entity	Incorrect or invalid search parameter