Skip to main content

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:

POST/v2/reputation
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.

POST/v2/reputation
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"}'
note

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?

Contact us