Views:

Last Updated: 1/22/2020 12:11:08 AM

Get top N URL Filtering violation during a time range

1. It returns the aggregated summary within one day if time range is not specified. 2. The largest query duration is 30 days.

Request

HTTP Request

GET /SMPI/{version}/service/wfbss/api/summary/url_categories

Parameters

Name

Type

Description

Validation

Optional Parameters

start_time

integer

Start time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC). end_time - start_time < 30 days

end_time

integer

End time of counting interval

Unix timestamp (seconds since 1970-01-01 00:00:00 UTC). If not set, the default is now.

top

integer

Top N records

1 to 100. Default is 100.

HTTP Request Example

Get top 100 URL categories since last day:
GET /SMPI/{version}/service/wfbss/api/summary/url_categories

Get top 50 URL categories since last day:
GET /SMPI/{version}/service/wfbss/api/summary/url_categories?top=50

Get top 100 of one-day URL categories after the specified time:
GET /SMPI/{version}/service/wfbss/api/summary/url_categories?begin_time=1369394768

Get top 100 of five-day URL categories after the specified time:
GET /SMPI/{version}/service/wfbss/api/summary/url_categories?begin_time=1369394768&end_time=1369826768

Request Body

Do not supply a request body with this method.

Response

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:

{
  "summary": {
    "url_categories": [
      {
        "count": 559,
        "id": 86
      },
      {
        "count": 559,
        "id": 75
      },
      {
        "count": 557,
        "id": 71
      }
    ]
  }
}

Name

Type

Description

Length

summary.url_categories[].count

integer

The number of violations for the filter rule

summary.url_categories[].id

integer

Filter rule ID

- Adult category: 1= Adult/Mature Content, 3 = Pornography, 4 = Sex Education, 5 = Intimate Apparel/Swimsuit, 6 = Nudity, 8 = Alcohol Tobacco, 9 = Illegal/Questionable, 10 = Tasteless, 11 = Gambling, 14 = Violence/Hate/Racism, 15 = Weapons, 16 = Abortion, 25 = Illegal Drugs, 26 = Marijuana; - Business category: 21 = Business/Economy, 31 = Financial Services, 32 = Brokerages/Trading, 45 = Job Search/Careers, 58 = Shopping, 59 = Auctions, 60 = Real Estate; - Communications and Search category: 24 = Internet Telephony, 40 = Search Engines/Portals, 41 = Internet Infrastructure, 42 = Blogs/Web Communications, 50 = Social Networking, 51 = Chat/Instant Messaging, 52 = Email, 53 = Newsgroups, 89 = Web Hosting; - General category: 27 = Education, 34 = Government/Legal, 35 = Military, 36 = Politics, 37 = Health, 38 = Computers/Internet, 46 = News/Media, 48 = Translators/Cached Pages, 49 = Reference, 67 = Vehicles, 90 = Unrated; - Internet Security category: 39 = Proxy Avoidance, 73 = Potentially Malicious Software, 74 = Spyware, 75 = Phishing, 76 = Spam, 77 = Adware, 78 = Malware Accomplice, 79 = Disease Vector, 80 = Cookies, 81 = Dialers, 82 = Hacking, 83 = Joke Program, 84 = Password Cracking, 84 = Password Cracking, 85 = Remote Access Program, 86 = Made for AdSense, 88 = Web Advertisement; - Lifestyle category: 18 = Recreation/Hobbies, 19 = Arts, 20 = Entertainment, 22 = Cult/Occult, 29 = Cultural Institutions, 30 = Activist Groups, 33 = Games, 44 = Alternative Journals, 47 = Personals/Dating, 54 = Religion, 55 = Personal Sites, 61 = Society/Lifestyle, 63 = Gun Clubs/Hunting, 64 = Restaurants/Food, 65 = Sports, 66 = Travel, 68 = Humor, 87 = For Kids; - Network Bandwidth category: 23 = Internet Radio and TV, 43 = Photo Searches, 56 = Personal Network Storage/File Download Servers, 57 = Peer-to-Peer, 69 = Streaming Media/MP3, 70 = Ringtones/Mobile Phone Downloads, 71 = Software Downloads, 72 = Pay to Surf