api.syo.su
Network admin REST API © 2023-2026 DenSyo
_________________________________________

Server name: api.syo.su
Server ip/port: 45.90.219.52:80
location: Moscow, Russia
time: 14:40 Wednesday, April 1, 2026

Your ip/port: 216.73.216.85:55586
location: Columbus, United States
time: 06:40 Wednesday, April 1, 2026
_________________________________________

Gateways:

api.syo.su	Moscow, Russia
cbr.syo.su	Canberra, Australia
sao.syo.su	Sao Paulo, Brazil
hkg.syo.su	Hong Kong, China
dub.syo.su	Dublin, Ireland
rig.syo.su	Riga, Latvia
ams.syo.su	Amsterdam, Netherlands
mos.syo.su	Moscow, Russia
vlk.syo.su	Vladivostok, Russia
vld.syo.su	Vladivostok, Russia
sin.syo.su	Singapore
nyk.syo.su	New York, United States

All functionality is available from any
gateway, but guaranteed operability is
only provided by the main one, use it for
working with the database, while the
others are primarily intended for testing
your firewall and route rules
_________________________________________

Ports:

http: 80, 8080
https: 443, 8443
_________________________________________

Endpoints:

myip: your host ip address
//api.syo.su/myip

myaddr: your host ip addresses
//api.syo.su/myaddr

whois: response of standard program whois
//api.syo.su/whois
//api.syo.su/whois?syo.su
//api.syo.su/whois?216.73.216.85

ipwhois: host or range information from
 databases and ptr request
//api.syo.su/ipwhois
//api.syo.su/ipwhois?syo.su
//api.syo.su/ipwhois?216.73.216.85

ip: host or range information only from
 databases
//api.syo.su/ip
//api.syo.su/ip?216.73.216.85
//api.syo.su/ip?216.73.216.85/21
//api.syo.su/ip?216.73.208.85-216.73.224.85

ip/lite: host or range information only
 from ip2location databases
//api.syo.su/ip/lite
//api.syo.su/ip/lite?216.73.216.85

ip/lite/geo: host or range information
 only from ip2location geo database
//api.syo.su/ip/lite/geo
//api.syo.su/ip/lite/geo?216.73.216.85

ip/lite/asn: host or range information
 only from ip2location asn database
//api.syo.su/ip/lite/asn
//api.syo.su/ip/lite/asn?216.73.216.85

ip/dev: host or range information only
 from maxmind database
//api.syo.su/ip/dev
//api.syo.su/ip/dev?216.73.216.85

gethost: get ip address by host name
//api.syo.su/gethost?syo.su

gethosts: get ip addresses by host name
//api.syo.su/gethosts?google.com

getname: get host ptr record
//api.syo.su/getname?216.73.216.85

ports: ports information (default all)
//api.syo.su/ports
//api.syo.su/ports/tcp?dns,rdp
//api.syo.su/ports/udp?1-9,3001-4000
_________________________________________

Scan your host:

ping: result of ping
//api.syo.su/ping

traceroute (or tracert): traceroute (icmp
 default)
//api.syo.su/tracert
//api.syo.su/tracert/icmp
//api.syo.su/traceroute/tcp
//api.syo.su/traceroute/udp

netcat: ports scan (max 100 per request,
 tcp only, udp makes no sense)
//api.syo.su/netcat
//api.syo.su/netcat?ftp-http,https

nmap: ports scan (max 100 per request,
 tcp default)
//api.syo.su/nmap
//api.syo.su/nmap/udp
//api.syo.su/nmap?ftp-ssh,dns,http,rdp
//api.syo.su/nmap/udp?20-50,3380-3400
_________________________________________

Routing:

By default, requests to your host will go
through the gateway you used to connect
//rig.syo.su/tracert
//mos.syo.su/tracert

Use the top-level domain name of any
gateway as the first part of the endpoint
to make requests to your host through
that gateway
//api.syo.su/dub/tracert
//sao.syo.su/api/tracert
//nyk.syo.su/sin/netcat
//cbr.syo.su/hkg/nmap
_________________________________________

Parameters:

join: line separator in text answer
 (default \r\n)
br - HTML <br>
lf - Unix \n
cr - Mac \r
use any combination:
crlf - Windows \r\n
brcrlf - <br> and \r\n
//api.syo.su/whois?216.73.216.85&join=lf
//api.syo.su/whois?join=br&syo.su

from: step from which to return search
 result for the address range (default 0)
//api.syo.su/ipwhois?216.73.216.85/8&from=1
//api.syo.su/ip?from=2&214.73.216.85-218.73.216.85
_________________________________________

Headers:

Accept: line separator in text answer
 (parameter join has priority)
text/html - <br>
text/plain - \n
all other - \r\n

Range: step from which to return search
 result for the address range
 (parameter from has priority)
_________________________________________

Console:

Using curl:
curl api.syo.su/ports?1-1000

Using wget for console output:
wget -qO- api.syo.su/tracert

Using jq for JSON response:
curl api.syo.su/myaddr | jq
wget -qO- api.syo.su/ip | jq

Windows versions also available
//curl.se/download.html
//eternallybored.org/misc/wget/
//jqlang.org/download/
_________________________________________

Download:

Simplified version IANA service name and
port number registry
//syo.su/download/iana-ports-all.csv
//syo.su/download/iana-ports-tcp.csv
//syo.su/download/iana-ports-udp.csv
//syo.su/download/iana-ports-dccp.csv
//syo.su/download/iana-ports-sctp.csv
//syo.su/download/iana-ports-as-array.json
//syo.su/download/iana-ports-by-number.json
//syo.su/download/iana-ports-by-protocol.json
//syo.su/download/iana-ports-by-name.json

IP databases
//syo.su/download/bogonIPv4.csv
//syo.su/download/ipdeny-zones.csv