Search

Look up a domain or host, search your own results, or page through full-text search.

Look up one name

These routes look up a domain or host. They do not start a scan.

GET/v3/search/domains/{domain}

URL, DNS, WHOIS, and RDAP for a domain

GET/v3/search/hosts/{host}

Port status for a host

GET/v3/search/hosts/{host}/summary

Host summary

GET/v3/search/my/hosts/{host}

Your own scan results for a host

curl -sS "https://api.efflux.io/v3/search/domains/example.com" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

curl -sS "https://api.efflux.io/v3/search/my/hosts/1.2.3.4?limit=20" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

Host search defaults to limit 50 (max 200). Your own host search defaults to 20 (max 100).

Three advanced routes share the same query style:

GET/v3/search/advanced/hosts

Full-text host search

GET/v3/search/advanced/urls

Full-text URL search

GET/v3/search/advanced/dns

Full-text DNS search

QueryMeaning
qSearch text
fieldsFields to search
limitPage size. Default 20, max 100
search_afternext_token from the previous page

The body is a SearchPagedResponse. pagination.next_token is the cursor for the next page. Send it back unchanged as search_after.

curl -sS -G "https://api.efflux.io/v3/search/advanced/hosts" \
  -H "Authorization: Bearer $EFFLUX_TOKEN" \
  --data-urlencode "q=nginx" \
  --data-urlencode "limit=20"

Hosts, URLs, and DNS each accept their own field filters alongside q.