Skip to main content

URL reputation

Review the basics of making API calls to URL Intel

Use the /reputation endpoint to make an API call and return URL details for an array of up to 100 URLs. You can create an API request to retrieve as few or as many details as you need.

API calls containing a single URL will return a 200 code and the results. When making an API call that includes multiple URLs, 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 URL​

To retrieve only the URL score (normalized by Pangea), create your API request using the only required body parameter: urls. Your API Request might look like the example below:

POST/v2/reputation
curl -sSLX POST 'https://url-intel.'"$PANGEA_DOMAIN"'/v2/reputation' \
-H 'Authorization: Bearer '$"PANGEA_INTEL_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"provider":"crowdstrike","urls":["http://113.235.101.11:54384"]}'

Retrieve a detailed intelligence report for a URL​

To receive a report containing provider data intelligence in your API response (in addition to the URL score), set raw and verbose 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://url-intel.'"$PANGEA_DOMAIN"'/v2/reputation' \
-H 'Authorization: Bearer '$"PANGEA_INTEL_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"provider":"crowdstrike","url":"http://113.235.101.11:54384","verbose":true,"raw":true}'
tip

You can also 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.

note

For more information, visit the interactive URL Intel API Reference.

Was this article helpful?

Contact us