API Documentation

link Base URL

https://zondex.io

All endpoints are relative to this base URL. Pass your API key via the X-API-Key header when authenticating.

GET

/api/search/

Search the Zondex index. Supports the full dork syntax. Returns paginated results (20 per page).

Parameters

Name	Type	Required	Description
q	string	Yes	Search query (dork syntax)
page	int	No	Page number (default: 1)

Example

# Search for SSH servers in Germany
curl "https://zondex.io/api/search/?q=service%3Assh+country%3ADE&page=1" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "results": [
    {
      "ip": "1.2.3.4",
      "port": 22,
      "service": "ssh",
      "product": "OpenSSH",
      "version": "8.9p1",
      "country_code": "DE",
      "scan_date": "2025-12-01",
      // ... ~65 columns total
    }
  ],
  "total": 4832,
  "page": 1,
  "query": "service:ssh country:DE"
}

GET

/api/facets/

Returns aggregated facet counts for a search query. Useful for building dashboards and understanding data distribution.

Parameters

Name	Type	Required	Description
q	string	Yes	Search query (dork syntax)

Example

# Get facets for nginx servers
curl "https://zondex.io/api/facets/?q=product%3Anginx" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "facets": {
    "port": [
      { "value": 443, "count": 128453 },
      { "value": 80, "count": 95621 }
    ],
    "country_code": [
      { "value": "US", "count": 45102 },
      { "value": "DE", "count": 22341 }
    ],
    "service": [...],
    "os_family": [...],
    "device_type": [...],
    "http_status_code": [...]
  }
}

GET

/api/export/

Export search results as CSV or JSON file. Maximum rows depend on your plan (Pro: 10,000, Enterprise: unlimited). Requires authentication.

Parameters

Name	Type	Required	Description
q	string	Yes	Search query (dork syntax)
format	string	No	`csv` (default) or `json`

Example

# Export SSH servers as CSV
curl -o results.csv "https://zondex.io/api/export/?q=service%3Assh&format=csv" \
  -H "X-API-Key: YOUR_API_KEY"

# Export as JSON
curl -o results.json "https://zondex.io/api/export/?q=service%3Assh&format=json" \
  -H "X-API-Key: YOUR_API_KEY"

Notes

CSV response has Content-Disposition: attachment header.
JSON export wraps results in {"results": [...], "total": N, "query": "..."}.
Results are sorted by scan_date DESC.

GET

/api/ai-search/

Converts a natural language query into Zondex dork syntax using Google Gemini Flash. Optionally returns search results alongside the generated dork.

Parameters

Name	Type	Required	Description
q	string	Yes	Natural language query
results	bool	No	`true` or `1` to include search results

Example

# Convert natural language to dork
curl "https://zondex.io/api/ai-search/?q=find+RDP+servers+in+China" \
  -H "X-API-Key: YOUR_API_KEY"

# With results included
curl "https://zondex.io/api/ai-search/?q=find+RDP+servers+in+China&results=true" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "query": "find RDP servers in China",
  "dork": "service:rdp country:CN",
  "explanation": "Searches for RDP services in China using country code CN.",
  "results": [...],  // only if results=true
  "total": 1523       // only if results=true
}

Notes

Results are cached for 5 minutes per unique query.
Available on Pro and Enterprise plans.

GET

/api/autocomplete/

Returns autocomplete suggestions for service names and product names matching the query prefix. Minimum 2 characters required.

Parameters

Name	Type	Required	Description
q	string	Yes	Search prefix (min 2 chars)

Example

# Get autocomplete suggestions for "ngi"
curl "https://zondex.io/api/autocomplete/?q=ngi"

Response

{
  "suggestions": [
    { "type": "service", "value": "nginx" },
    { "type": "product", "value": "nginx" },
    { "type": "product", "value": "nginx-proxy" }
  ]
}

error_outline Error Responses

Status	Meaning	Body
400	Bad Request — missing or invalid parameters	{"error": "..."}
403	Forbidden — rate limit exceeded or feature not in plan	{"error": "..."}
500	Internal Server Error	{"error": "..."}

speed Rate Limits

API rate limits depend on your plan. Exceeding your limit returns a 403 response.

Plan	Daily API calls	Export rows
Free	5	N/A
Starter	100	N/A
Pro	Unlimited	10,000
Enterprise	Unlimited	Unlimited

link Base URL

/api/search/

Parameters

Example

Response

/api/facets/

Parameters

Example

Response

/api/export/

Parameters

Example

Notes

/api/ai-search/

Parameters

Example

Response

Notes

/api/autocomplete/

Parameters

Example

Response

error_outline Error Responses

speed Rate Limits

auto_awesome AI Search Gemini Flash