api.syo.su
Network admin REST API © 2023-2026 DenSyo
_________________________________________
Server name: vlk.syo.su
Server ip/port: 5.100.121.145:443
location: Vladivostok, Russia
time: 16:08 Sunday, February 22, 2026
Your ip/port: 216.73.216.149:7314
location: Columbus, United States
time: 01:08 Sunday, February 22, 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
_________________________________________
Endpoints:
myip: your host ip address
http://api.syo.su/myip
myaddr: your host ip addresses
http://api.syo.su/myaddr
whois: response of standard program whois
http://api.syo.su/whois
http://api.syo.su/whois?syo.su
http://api.syo.su/whois?216.73.216.149
ipwhois: host or range information from
databases and ptr request
http://api.syo.su/ipwhois
http://api.syo.su/ipwhois?syo.su
http://api.syo.su/ipwhois?216.73.216.149
ip: host or range information only from
databases
http://api.syo.su/ip
http://api.syo.su/ip?216.73.216.149
http://api.syo.su/ip?216.73.216.149/21
http://api.syo.su/ip?216.73.208.149-216.73.224.149
ip/lite: host or range information only
from ip2location databases
http://api.syo.su/ip/lite
http://api.syo.su/ip/lite?216.73.216.149
ip/lite/geo: host or range information
only from ip2location geo database
http://api.syo.su/ip/lite/geo
http://api.syo.su/ip/lite/geo?216.73.216.149
ip/lite/asn: host or range information
only from ip2location asn database
http://api.syo.su/ip/lite/asn
http://api.syo.su/ip/lite/asn?216.73.216.149
ip/dev: host or range information only
from maxmind database
http://api.syo.su/ip/dev
http://api.syo.su/ip/dev?216.73.216.149
gethost: get ip address by host name
http://api.syo.su/gethost?syo.su
gethosts: get ip addresses by host name
http://api.syo.su/gethosts?google.com
getname: get host ptr record
http://api.syo.su/getname?216.73.216.149
ports: ports information (default all)
http://api.syo.su/ports
http://api.syo.su/ports/tcp?dns,rdp
http://api.syo.su/ports/udp?1-9,3001-4000
_________________________________________
Scan your host:
ping: result of ping
http://api.syo.su/ping
traceroute (or tracert): traceroute (icmp
default)
http://api.syo.su/tracert
http://api.syo.su/tracert/icmp
http://api.syo.su/traceroute/tcp
http://api.syo.su/traceroute/udp
netcat: ports scan (max 100 per request,
tcp only, udp makes no sense)
http://api.syo.su/netcat
http://api.syo.su/netcat?ftp-http,https
nmap: ports scan (max 100 per request,
tcp default)
http://api.syo.su/nmap
http://api.syo.su/nmap/udp
http://api.syo.su/nmap?ftp-ssh,dns,http,rdp
http://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
http://rig.syo.su/tracert
http://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
http://api.syo.su/dub/tracert
http://sao.syo.su/api/tracert
http://nyk.syo.su/sin/netcat
http://cbr.syo.su/hkg/nmap
_________________________________________
Parameters:
join: line separator in text answer
(default \r\n)
br - HTML
lf - Unix \n
cr - Mac \r
use any combination:
crlf - Windows \r\n
brcrlf -
and \r\n
http://api.syo.su/whois?216.73.216.149&join=lf
http://api.syo.su/whois?join=br&syo.su
from: step from which to return search
result for the address range (default 0)
http://api.syo.su/ipwhois?216.73.216.149/8&from=1
http://api.syo.su/ip?from=2&214.73.216.149-218.73.216.149
_________________________________________
Headers:
Accept: line separator in text answer
(parameter join has priority)
text/html -
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 http://api.syo.su/ports?1-1000
Using wget for console output:
wget -qO- http://api.syo.su/tracert
Using jq for JSON response:
curl http://api.syo.su/myaddr | jq
wget -qO- http://api.syo.su/ip | jq
Windows versions also available
https://curl.se/download.html
https://eternallybored.org/misc/wget/
https://jqlang.org/download/
_________________________________________
Download:
Simplified version IANA service name and
port number registry
http://syo.su/download/iana-ports-all.csv
http://syo.su/download/iana-ports-tcp.csv
http://syo.su/download/iana-ports-udp.csv
http://syo.su/download/iana-ports-dccp.csv
http://syo.su/download/iana-ports-sctp.csv
http://syo.su/download/iana-ports-as-array.json
http://syo.su/download/iana-ports-by-number.json
http://syo.su/download/iana-ports-by-protocol.json
http://syo.su/download/iana-ports-by-name.json
IP databases
http://syo.su/download/bogonIPv4.csv
http://syo.su/download/ipdeny-zones.csv