Intelligence

ASN Lookup

post

This method takes an array of ASNs and looks up the corresponding ORG.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

asnsinteger[] · max: 1000Required

Array of AS numbers to lookup org names for

Responses

200

ASN Number and Organisation the ASN provided in the request.

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

post

/api/v1/intel/lookup/asns

HTTPcURLJavaScriptPython

POST /api/v1/intel/lookup/asns HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "asns": [
    65001,
    65002,
    65003
  ]
}

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": [
    {
      "number": 15169,
      "org": "Google LLC"
    }
  ]
}

CVE Lookup

get

Returns Common Vulnerability and Exposure information for the CVE ID provided. For more information on the data returned, see the NIST NVD CVE API response documentation

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

cveidstringRequired

The unique Common Vulnerabilities and Exposures identifier (the CVE ID)

Responses

200

OK

No content

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

get

/api/v1/cve/{cveid}

HTTPcURLJavaScriptPython

GET /api/v1/cve/{cveid} HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

IP Lookup

post

This method takes an array of IPs and looks up the corresponding information.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

asbooleanOptional

Include Autonomous System information in the response

Example: true

bogonbooleanOptional

Include bogon intellegence in the response

Example: true

geobooleanOptional

Include Geolocation Data in the response

Example: true

iprepbooleanOptional

Include IP Reputation intellegence in the response

Example: true

rdnsbooleanOptional

Include RDNS info in the response

Example: true

pdnsbooleanOptional

Include PDNS info in the response

Example: true

ipsstring[] · max: 1000Required

Array of IP addresses to lookup

Example: {"ips":["1.0.0.32","125.64.94.221","85.105.167.67","185.176.27.42","fe80::4f1:cde3:2b85:7c7d","162.243.150.19"]}

Responses

200

Ip Intelligence information for the ip addresses provided in the request.

application/json

400

Bad Request. Typically due to a malformatted JSON body, or parameter values are not validating.

application/json

401

Access token is missing or invalid

application/json

403

Access is forbidden

application/json

default

Unknown Error Occurred

application/json

post

/api/v1/intel/lookup/ips

HTTPcURLJavaScriptPython

POST /api/v1/intel/lookup/ips HTTP/1.1
Host: api.netography.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "as": true,
  "bogon": true,
  "geo": true,
  "iprep": true,
  "rdns": true,
  "pdns": true,
  "ips": {
    "ips": [
      "1.0.0.32",
      "125.64.94.221",
      "85.105.167.67",
      "185.176.27.42",
      "fe80::4f1:cde3:2b85:7c7d",
      "162.243.150.19"
    ]
  }
}

{
  "meta": {
    "code": 200,
    "count": 1
  },
  "data": [
    {
      "bogon": false,
      "ip": "1.0.0.32",
      "firstseen": 1617980476,
      "lastseen": 1617991633,
      "count": 32,
      "iprep": {
        "count": 32,
        "categories": [
          "ddos"
        ]
      },
      "geo": {},
      "as": {
        "number": 15169,
        "org": "Google LLC"
      },
      "rdns": false,
      "pdns": {
        "count": 32,
        "records": [
          "text"
        ]
      }
    }
  ]
}