API DOCUMENTATION

Please read the API documentation carefully before sending requests to the server. Any attempt to brute-force the server may result in temporary and then permanently banning the IP address of the senders. So please use the API in a reasonable way.

get_blacklist_by_date

API URL: https://api.korlabs.io/utils/get_blacklist_by_date

Returns blacklisted URLs for the specified feed

This API returns the blacklisted URLs from various feeds Aggregated in one web-service. Each call to the API is limited to 100 results. Therefore, you need to increase the page parameter to get more results. The page parameter starts from 1.

The src parameter selects the feed to get the data. You will receive the list of feeds along with the authentication token.

By specifying the ts parameter, we will serve all the data we discovered after this timestamp.

Input Parameters

Here is the list of input parameters.

#	Name	Type	Presence	Description
1	token	string	mandatory	user-provided token in order to access the API
2	ts	string	mandatory	(the UNIX timestamp). We serve the data which have been discovered after this time.
3	src	string	mandatory	the name of the feed to receive the data from.
4	page	integer	optional	the page number of the result (starts from 1 and each page contains 100 results)

Return value

get_blacklist_by_id

API URL: https://api.korlabs.io/utils/get_blacklist_by_id

Returns blacklisted URLs for the specified feed

This API returns the blacklisted URLs from various feeds Aggregated in one web-service. Each call to the API is limited to 100 results. Therefore, you need to increase the page parameter to get more results. The page parameter starts from 1.

The src parameter selects the feed to get the data. You will receive the list of feeds along with the authentication token.

By specifying the feedid parameter, we will serve all the data we discovered after this ID. This API endpoint is faster than calling by date. However, you need to keep track of the latest data ID you fetched.

Input Parameters

Here is the list of input parameters.

#	Name	Type	Presence	Description
1	token	string	mandatory	user-provided token in order to access the API
2	feedid	string	mandatory	(Integer). We serve all the records after this unique ID.
3	src	string	mandatory	the name of the feed to receive the data from.
4	page	integer	optional	the page number of the result (starts from 1 and each page contains 100 results)

Return value