Domain reputation
Review the basics of making API calls to Domain Intel
Use the /reputation endpoint to make an API call and return the domain details of up to 100 domains. You can create an API request to retrieve as few or as many details as you need.
API calls containing a single domain will return a 200 code and the results. When making an API call that includes multiple domains, the response will be asynchronous and return a 202 instead of immediately returning the results. You will then need to poll for the results. For more information, visit our Asynchronous API response page.
Look up the reputation score of a domain
To retrieve only the domain score (normalized by Pangea), create your API request using the only required
parameter: domain
. Your API Request might look like the example below:
curl -sSLX POST 'https://domain-intel.'"$PANGEA_DOMAIN"'/v2/reputation' \
-H 'Authorization: Bearer '"$PANGEA_INTEL_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"domains":["www.example.com"]}'
Retrieve detailed intelligence report for a domain
Besides the normalized result, you can choose to receive the raw results from a provider that may include more detailed
values for your specific use case (in addition to the domain score). The raw values will vary based on the provider. To do
this set raw
to true in your API request. and make sure you've set a provider as default in the Pangea Console.
curl -sSLX POST 'https://domain-intel.'"$PANGEA_DOMAIN"'/v2/reputation' \
-H 'Authorization: Bearer '"$PANGEA_INTEL_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"domains":["www.example.com"],
"raw":true,
"provider":"ProviderName"}'
You can also select a provider and override the default provider by specifying their name in the provider
field
when making an API request to the /reputation endpoint. This is helpful if your default provider returns a verdict of Unknown
and you want a second opinion from another provider.
Was this article helpful?