Get user tags

Retrieve tags for one or more users.

Request method

POST: https://Base URL/v4/user/tag/batch/get

Rate limit: 100 requests per second

Signature required: All server API requests require signature verification. See API request signature.

Request body

The request body is in application/json format and supports the following parameters:

Parameter	Type	Required	Description
userIds	String[]	Yes	User IDs. Maximum 50 per request.

Request example

HTTP

POST /v4/user/tag/batch/get HTTP/1.1
Host: api.sg-light-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408706337000
Signature: 890b422b75c1c5cb706e4f7921df1d94e69c17f4
Content-Type: application/json

{
  "userIds": ["u01", "u02"]
}

Response

Field	Type	Description
code	Number	Status code. 0 indicates success.
result.users	Object[]	List of user tag entries.
result.users[].userId	String	User ID.
result.users[].tags	String[]	List of tags for this user.

Response example

HTTP

HTTP/1.1 200 OK
Content-Type: application/json

{
  "code": 0,
  "result": {
    "users": [
      {
        "userId": "u01",
        "tags": ["tag-a", "tag-b"]
      },
      {
        "userId": "u02",
        "tags": ["tag-c"]
      }
    ]
  }
}