App

Data Feed Quick Start

Two ways to quickly download Spur feed data.

Download from the website

If your enterprise subscription is linked to an online organization, head over to the Data-Feeds Dashboard to view metrics and download a feed directly.

  1. 1
    Click "Download" from your desired feed menu

    image

  2. 2
    Open the downloaded file using your operating system or a tool like gunzip

    image

  3. 3
    That's it!

    The decompressed feed file will contain newline-separated JSON objects for each IP address. Use your preferred JSON viewer or ingest it into a JSON-capable database.

Download from the command-line

If you have your Feed token and want to download the latest feed, use the following command-line steps. You can replace anonymous with anonymous-residential or any other feed type included in your subscription.

GET /v2/anonymous/latest.json.gz
curl "https://feeds.spur.us/v2/anonymous/latest.json.gz" -o latest.json.gz -L -H "Token: {{token}}" 
gunzip latest.json.gz
head latest.json
latest.json
{"ip":"1.0.204.195","organization":"Dynamic IP Address for residential Broadband Customers","as":{"number":23969,"organization":"TOT Public Company Limited"},"client":{"count":5,"types":["MOBILE"],"concentration":{"geohash":"w4rqew","city":"Bang Yai","state":"Nonthaburi","country":"TH","skew":703,"density":0.5601},"spread":27926,"countries":1},"tunnels":[{"operator":"SMILE_VPN","type":"VPN","anonymous":true}],"services":["OPENVPN"],"location":{"city":"Trang","state":"Trang","country":"TH"},"risks":["TUNNEL"]}
{"ip":"1.0.204.196","organization":"Dynamic IP Address for residential Broadband Customers","as":{"number":23969,"organization":"TOT Public Company Limited"},"client":{"count":5,"types":["MOBILE"],"concentration":{"geohash":"w691f1","city":"Non Din Daeng","state":"Buriram","country":"TH","skew":835,"density":0.5},"spread":70102,"countries":1},"tunnels":[{"operator":"SMILE_VPN","type":"VPN","anonymous":true}],"services":["OPENVPN"],"location":{"city":"Trang","state":"Trang","country":"TH"},"risks":["TUNNEL"]}
{"ip":"1.0.90.90","organization":"Enecom,Inc.","as":{"number":18144,"organization":"Enecom,Inc."},"client":{"count":2,"types":["MOBILE"],"behaviors":["FILE_SHARING"],"proxies":["DATAIMPULSE_PROXY","PACKETSTREAM_PROXY","NSOCKS_PROXY","PROXYRACK_PROXY","IPIDEA_PROXY"]},"tunnels":[{"operator":"VPNGATE_VPN","type":"VPN","anonymous":true}],"location":{"city":"Matsue","state":"Shimane","country":"JP"},"risks":["CALLBACK_PROXY","TUNNEL"]}
{"ip":"1.116.118.117","organization":"Tencent cloud computing (Beijing) Co., Ltd.","as":{"number":45090,"organization":"Shenzhen Tencent Computer Systems Company Limited"},"client":{},"tunnels":[{"type":"PROXY","anonymous":true}],"infrastructure":"DATACENTER","location":{"city":"Shanghai","state":"Shanghai","country":"CN"},"risks":["TUNNEL"]}
{"ip":"1.116.154.193","organization":"Tencent cloud computing (Beijing) Co., Ltd.","as":{"number":45090,"organization":"Shenzhen Tencent Computer Systems Company Limited"},"client":{},"tunnels":[{"type":"PROXY","anonymous":true}],"services":["3PROXY"],"infrastructure":"DATACENTER","location":{"city":"Shanghai","state":"Shanghai","country":"CN"},"risks":["TUNNEL"]}
...