api documentation / proxycheck.io

Last Update: 1st of June 2019
1st of June 2019
Added a table to the Service Limits section to explain how our CDN caches queries for different account types.
24th of May 2019
  • Per second request limiter resolution increased from 1 second to 10 seconds. Documentation was updated to reflect this change.
  • CDN Edge caching was enabled, your queries are now cached for 10 seconds at the edge (unique, per-customer caching, uses entire request url as cache salt)
  • 18th of May 2019
    Updated the Code Libraries section to indicate that the PHP Library authored by proxycheck.io now has full dashboard API support, previously it only had partial support.
    24th of April 2019
    Completely redesigned the API Documentation, now includes a movable side navigation menu, rewritten most documentation, a brand new test console and removal of v1 API documentation.
    19th of April 2019
    The v2 API documentation was updated to include two new status codes for request limits. We now have a soft per-second request limit of 100 and a hard limit of 125.

    Updated the &days= flag to show it now supports float values, you can for example supply &days=0.01 to check our data from only within the past 24 minutes.
    6th of March 2019
    Updated the v2 documentation to include our new risk flag which provides you with a risk assessment score between 0 and 100 when checking an IP Address against the API.
    19th of February 2019
    Added new documentation for the pagination feature which has been added to the JSON export feature of the positive detection log wishin customer dashboards.
    12th of February 2019
    Added new type responses for ShadowSocks and OpenVPN servers.
    20th of December 2018
    Altered the API Call text for the v2 API to make it more clear that multiple addresses can be checked within a single request using a POST method.
    23rd of November 2018
    The v2 API documentation was updated to include new information about our ASN flag which now includes city and langitude and longitude coordinates if known for the IP being checked.
    15th of November 2018
    Updated the v2 API documentation to include all current type responses and explanations for them.
    6th of August 2018
    Updated the v2 API documentation to say we now allow 10,000 IP's to be checked in a single query up from 1,000.
    3rd of July 2018
    The way our tag flag functions has been altered and so we adjusted the tag flag documentation to include an explanation on how you can disable tagging. We also added a new section regarding the storage limits of positive detections within your account when supplying blank tags.
    29th of June 2018
    Country ISO Codes were added to both the v1 and v2 API endpoints when supplying the &asn=1 flag and so the documentation was updated to include this new response in all examples.
    27th of June 2018
    Added a new Country Array section which lists all the countries you can expect in a query response from our API when using the &asn=1 flag.
    26th of May 2018
    Added a new Query Flag Reference section.
    4th of May 2018
    A new export API has been added to the Dashboard API tab so you can view your daily query allowance.
    19th of April 2018
    New status codes and messages have been added to the v2 API, the documentation on this page has been updated with all the information regarding this new feature.
    15th of March 2018
    Updated v2 API documentation to include new Port, Days and Seen flags. Changed format of flag viewing to a cursor hover and reveal interface.
    5th of February 2018
    Updated wording on v2 API documentation to explain the API now allows 1,000 IP Addresses to be checked in a single query and we now have a 90 second processing time limit per query made.
    5th of February 2018
    New specific error text examples were added to the bottom of the v2 API documentation.
    1st of January 2018
    Updated the API documentation for our new v2 API endpoint, altered the appearance of the page to use our new CSS style.