API Reference
Unless otherwise noted all endpoints in the documentation starts with the following URL:
https://dev.metacert.com/v5
Authentication
The following authentication method is supported:
| Type | Name | Description | Details |
|---|---|---|---|
| API Key | apikey | API Key Authentication | Pass As: HTTP Header Keyname: apikey |
Resources
check (POST https://dev.metacert.com/v5/check/)
Looks up the reputation of a URL against subscribed categories.
Sample request
POST /v5/check/ HTTP/1.1
Host: dev.metacert.com
Content-Type: application/json
{
"url": "http://example.org/"
}
Developer Note
1. URL without file path extensions should always have a trailing slash (/).
2. Only properly escaped URL should be used for API call.
3. Use only lowercase format of URL while making the call.
4. If you have multiple URL structure present within your URL, only the last one will be checked by API.
5. Be mindful about hidden illegal characters in your head/body of the call.
Sample response
{
"status": {
"code": 200,
"message": "OK"
},
"data": {
"URLs": [
],
"Folders": [
],
"Domains": [
{
"domain": "example.org",
"type": "malware-phishing"
}
]
}
}
Error codes
| Error Code | Message |
|---|---|
| 400 | Bad request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Resource not found |
| 502 | Bad gateway |
| 503 | Service Unavailable |
