API Documentation

API Reference

Unless otherwise noted all endpoints in the documentation starts with the following URL:


The following authentication method is supported:

Type Name Description Details
API Key apikey API Key Authentication Pass As: HTTP Header
Keyname: apikey


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

Get 150 FREE API calls EVERY month

YES, Sign me up!

Get 150 FREE API calls EVERY month

YES, Sign me up!