Tor Exit Nodes Geolocated API

Introduction

Due to privacy concerns, various solutions have emerged which aim to protect your online identity and enable you to surf the internet with anonymity. The Tor project is one such initiative managed by volunteers across the globe.

However, this can result in inconvenience if you are trying to deliver personalised content and also such systems can allow online scammers to carry out fraudulent activities. Hence, you can use the Insights API to identify and isolate such traffic on your websites. 

This API returns a list of active Tor exit nodes geolocated to country-level along with active carrier information.

Unprecedented Update Rate

  • TOR Exit Node Data: updated every hour

Example Response

The response is only available in JSON format. The below response should be expected for the following request:


https://api.bigdatacloud.net/data/tor-exit-nodes-list


Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

NEW! Payload compression is supported, simply add Accept-Encoding: gzip header.
Use the form below to try out this API.

Parameter Your Input Value Description
batchSize Requested batch size. Maximum value = 1000
offset Offset. Number of entries to skip
sort

Sort response by a field value, acceptable values:

·       ip

·       countryName

·       countryCode

·       carriers

Default – sorted by ip
order Sort order, acceptable values: asc, desc. Default - asc
localityLanguage

Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided
key Your API key

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.

The live query

https://api.bigdatacloud.net/data/tor-exit-nodes-list


CURL Example

curl -X GET --header 'Accept: application/json' 'https://api.bigdatacloud.net/data/tor-exit-nodes-list'


Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.


Response

Awaiting request submission...

Response Format

Field

Data type

Description

total

16 bit unsigned integer

Total number of nodes available

offset

32 bit unsigned integer

Number of entries skipped

batch

16 bit unsigned integer

Number of entries in the current batch

nodes

Array of <Node> objects

Array of node entries returned

API Endpoint

Endpoint: /data/tor-exit-nodes-list
Full URL: https://api.bigdatacloud.net/data/tor-exit-nodes-list

Data Objects

Node object

Field

Data type

Description

ip

string

TOR node IP address

countryName

string

Country name localised to the language as defined by ‘localityLanguage’ request parameter

countryCode

string

Country ISO 3166-1 Alpha-2 code

carriers

Array of <Carrier> objects

List of Autonomous Systems (AS) announcing this IP address on BGP

Carrier object

Field

Data type

Description

asn

string

Autonomous System Number string

asnNumeric

32 bit unsigned integer

Autonomous System Number

organisation

string

Registered Organisation

name

string

Registered name

registry

string

The Regional Internet Registry (RIR) the AS is registered with

registeredCountry

string

Registered Country ISO 3166-1 Alpha-2 code

registeredCountryName

string

Registered Country localised name. The language is as defined by 'localityLanguage' request parameter

registrationDate

string

Registration date in “yyyy-mm-dd” format

registrationLastChange

string

Registration modification date in “yyyy-mm-dd” format

totalIpv4Addresses

32 bit unsigned integer

Total number of IP addresses announced by the AS

totalIpv4Prefixes

32 bit unsigned integer

Total number of BGP prefixes announced by the AS

totalIpv4BogonPrefixes

32 bit unsigned integer

Total number of bogon prefixes announced by the AS

rank

32 bit unsigned integer

World rank by total number of IP addresses announced

rankText

string

World rank by total number of IP addresses announced including total

 

Related APIs

  1. IPv4 Address Space Monitoring API
    FREE 10,000 queries/month
    Additional 10,000 queries
    US$1.00
    /month

    Returns IPv4 address space registration and BGP announcement status

    • Address space distribution by RIR
    • Announced space by RIR
    • Announced bogon space by RIR
    • Utilised/Unutilised space by RIR
    Read More

Sidebar