terminal
Bash & cURL Integration
Query the Zondex API directly from your terminal. Process results with jq, pipe to other tools, and build shell scripts.
search Basic Search
Search Zondex with cURL and format output with jq.
# Simple search
curl -s "https://zondex.io/api/search/?q=port:22" \
-H "X-API-Key: $ZONDEX_API_KEY" | jq .
# Extract just IPs
curl -s "https://zondex.io/api/search/?q=port:22+country:US" \
-H "X-API-Key: $ZONDEX_API_KEY" | \
jq -r '.results[].ip'
# Get total count for a query
curl -s "https://zondex.io/api/search/?q=product:nginx" \
-H "X-API-Key: $ZONDEX_API_KEY" | \
jq '.total'
bar_chart Get Statistics
Retrieve aggregated facets for a query.
# Top countries running SSH
curl -s "https://zondex.io/api/facets/?q=service:ssh" \
-H "X-API-Key: $ZONDEX_API_KEY" | \
jq -r '.countries[] | "\(.value)\t\(.count)"'
# Top ports for a country
curl -s "https://zondex.io/api/facets/?q=country:DE" \
-H "X-API-Key: $ZONDEX_API_KEY" | \
jq -r '.ports[] | "\(.value)\t\(.count)"' | \
head -10
description Shell Script Examples
Build reusable shell functions for common tasks.
#!/bin/bash
# Zondex API helper functions
ZONDEX_API="https://zondex.io"
API_KEY="${ZONDEX_API_KEY:-}"
zondex_search() {
local query="$1"
local page="${2:-1}"
curl -s "$ZONDEX_API/api/search/?q=$(urlencode "$query")&page=$page" \
-H "X-API-Key: $API_KEY"
}
# Search and save IPs to file
zondex_search "port:3389 country:US" | \
jq -r '.results[].ip' > rdp_hosts.txt
# Count results for multiple queries
for port in 22 80 443 3306 8080; do
count=$(zondex_search "port:$port" | jq '.total')
echo "Port $port: $count hosts"
sleep 1 # respect rate limits
done
link Pipe to Other Tools
Combine Zondex output with nmap, whois, and other security tools.
# Pipe results to nmap for version detection
zondex_search "port:8080 country:US" | \
jq -r '.results[] | "\(.ip):\(.port)"' | \
head -5 | \
while read target; do
echo "Scanning $target"
# nmap -sV -p "${target##*:}" "${target%%:*}"
done
# Export to CSV
zondex_search "product:Apache" | \
jq -r '.results[] | [.ip, .port, .product, .country_code] | @csv' > results.csv