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: 17:12 Tuesday, February 10, 2026
Your ip/port: 18.97.9.175:35732
location: Ashburn, United States
time: 09:12 Tuesday, February 10, 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?18.97.9.175
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?18.97.9.175
ip: host or range information only from
databases
http://api.syo.su/ip
http://api.syo.su/ip?18.97.9.175
http://api.syo.su/ip?18.97.9.175/21
http://api.syo.su/ip?18.97.1.175-18.97.17.175
ip/lite: host or range information only
from ip2location databases
http://api.syo.su/ip/lite
http://api.syo.su/ip/lite?18.97.9.175
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?18.97.9.175
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?18.97.9.175
ip/dev: host or range information only
from maxmind database
http://api.syo.su/ip/dev
http://api.syo.su/ip/dev?18.97.9.175
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?18.97.9.175
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?18.97.9.175&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?18.97.9.175/8&from=1
http://api.syo.su/ip?from=2&16.97.9.175-20.97.9.175
_________________________________________
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 wget for console output:
wget -qO- http://api.syo.su/tracert
Using jq for JSON response:
wget -qO- http://api.syo.su/ip | jq
Windows versions also available
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/liteIPv4DB1.csv
http://syo.su/download/liteIPv4DB3.csv
http://syo.su/download/liteIPv4DB11.csv
http://syo.su/download/liteIPv4ASN.csv
http://syo.su/download/liteIPv4PX1.csv
http://syo.su/download/liteIPv4PX12.csv