Get URLs for Category

This URL gets the list of urls for category.

Resource URL

GET /ntbamonitors/{ntbaId}/ topurlsbycategory/<category_id>? TopN=<TopN> &timePeriod=<timePeriod>&startTime=<startTime>&endTime=<endTime>

Request Parameters

Field Name	Description	Data Type	Mandatory
`ntbaId`	NTBA monitor id	Number	Yes
`TopN`	Number of top rows, default 50.	Number	No
`timePeriod`	Duration: can be LAST_MINUTE LAST_10_MINUTES LAST_HOUR LAST_24_HOURS CUSTOM Custom incase start and end time is provided	String	No
`startTime`	Start time in the format: yyyy-MM-dd HH:mm	String	No
`endTime`	End time in the format: yyyy-MM-dd HH:mm	String	No
`Category_id`	Category id	Number	Yes

Response Parameters

Following fields are returned if the request parameters are correct, otherwise error details are returned.

Field Name	Description	Data Type
`topURLsOnNetwork`	List of URLs	Array

Details of topURLsOnNetwork:

Field Name	Description	Data Type
`reputation`	Reputation	String
`url`	URL	Number
`urlId`	URL id	String
`country`	Country	String
`count`	Count	Number

Example

Request

GET https://<NSM_IP>/sdkapi/ntbamonitors/1006/topurlsbycategory/188?timePeriod=CUSTOM&startTime=2012-APR-20

Response

{
"topURLsOnNetwork":[{
"reputation":"Minimal Risk","url":"twitter.com","urlId":"8390917","category":"Blogs/Wiki","country":"United States","count":6},{"reputation":"Minimal Risk","url":"wikipedia.org","urlId":"10536655","category":"Education/Reference","country":"United States","count":7}]
}

Error Information

Following error codes are returned by this URL:

S.No	HTTP Error Code	SDK API errorId	SDK API errorMessage
1	400	4301	Invalid duration
2	400	4302	Invalid time format
3	400	4303	Start time is greater than end time
4	400	4304	Invalid date format
5	400	4305	Start/End date is not provided
6	400	4306	Invalid NTBA id
7	400	4308	Invalid category id