NOTE: this API is only available to Griffin View & Griffin View ASM Edition subscribers with a non-commercial use license. Contact us for details.

ASD Domain Tld APIv1

This API is used to launch a discovery of related domain in regards to Top-Level Domain (TLD). The goal is to find other TLDs for given domain(s).

By default, we execute the API call in trusted mode, meaning we filter obvious false positives directly from the backend. If you want to do the filtering yourself, you have to turn off the trusted mode.

Using curl

Call with default parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/domain/tld' -d '{ "domain":"DOMAIN.TLD" }'

Call against multiple domains and some custom parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/domain/tld' -d '{ "domain":["DOMAIN1.TLD","DOMAIN2.TLD"],"includep":["PATTERN1","PATTERN2"],"excludep":["PATTERN1","PATTERN2"],"trusted":"false","astask":"false","aslines":"true" }'

Available parameters

• domain: one or more domain in array format. Mandatory parameter.
• aslines: render results with context information (false) or one JSON per line (true). Default to false.
• astask: create a background task for later processing (true). Default to false.
• includep: one or more patterns to grep into result values and only keep matches.
• excludep: one or more patterns to grep into result values and exclude matches.
• trusted: let our backend do the filtering of obvious false positives (true) or disable it (false). Default to true.

Using ONYPHE CLI

onyphe -asd-domain-tld DOMAIN.TLD
onyphe -asd-domain-tld DOMAIN1.TLD,DOMAIN2.TLD

echo 'domain:"DOMAIN1.TLD"' > /tmp/domain.txt
echo 'domain:"DOMAIN2.TLD"' >> /tmp/domain.txt
onyphe -asd-domain-tld domain.txt

Error codes

error: 0, text: 'success'
error: 1, text: 'internal failure'
error: 2, text: 'request timed out'
error: 3, text: 'connection refused'
error: 4, text: 'unable to fork a new process'
error: 1000, text: 'API not found'
error: 1001, text: 'API access denied'
error: 1002, text: 'parameter error'
error: 1003, text: 'user not found'
error: 1004, text: 'user get failed'
error: 1005, text: 'no more credits'
error: 1006, text: 'search failed'
error: 1007, text: 'task not found'
error: 1008, text: 'creating task failed'
error: 1009, text: 'getting task result failed'
error: 1010, text: 'task in progress'
error: 1011, text: 'too many results, you should create a task'
error: 1012, text: 'unable to kill task'
error: 1013, text: 'resolver failed'