Last month we added a new feature to the dashboard which lets you view your recent positive detections as determined by our API. Here is a screenshot of this feature:
Since we added it we've had some customers ask us for a more convenient export feature. At first we allowed you to download your complete recent detections to a text file but this is mostly useful for human reading and not for easily parsing by computers.
So today we've added a new button as seen in the screenshot above called JSON Export. When you click this you'll open the most recent 100 entries in a new tab of your web browser and you'll notice the url contains your API Key and a limit variable.
This is what the url structure looks like:
https://proxycheck.io/dashboard/export/detections/?json=1&limit=100&key=111111-222222-333333-444444
If you don't supply your API Key we'll check your browser for a cookie and session token like we do for log downloads and in-dashboard page browsing.
Now the point of allowing you to specify your API Key in the request URL is so that you can create software on your side which automatically parses your recent positive detections. For example perhaps you don't want to setup logging on your side for positive detections and would rather have an overview from us. It's a no-fuss turn-key solution which will allow you to integrate your positive detections into any control panels you may have on your side.
And we've provided the limiter so you can specify how many recent entries you want to view. If you set this to 0 or remove it entirely we will send you your entire positive detection log.
You may notice that the URL for this feature starts in a new /export/ directory. It is our intention to expand the kinds of data you can export to include whitelist and blacklists (and also adding entries to these through the API too). We'll also be adding account controls to specify whether these sorts of things can be queried by your API Key alone or whether you only want them accessible from within the dashboard itself.
The new export feature does not count towards your normal API queries so you are free to query it as much as you need to. If you're querying it very frequently please use the limiter variable to receive only the most recent queries that are relevant to you.
And of course this feature is accessible to all our customers whether you're on our free or paid plans.
Have a great day!