IP Detection

Bulk-IP-checks

Beoordeel een lijst adressen in één verzoek, of stream de resultaten zodra ze binnen zijn.

Een lijst checken

POST/v1/bulk/check

API-sleutel

Parameters

ipsstring[]
Adressen, optioneel met poort. Stuur dit of input.
inputstring
Geplakte tekst; de server vindt de adressen erin.

Antwoordvelden

submittedinteger
Ontvangen items.
uniqueinteger
Unieke gecontroleerde adressen.
duplicatesinteger
Adressen die meer dan eens zijn gestuurd.
invalidstring[]
Invoer die geen bruikbaar adres was.
summaryobject
Aantal resultaten per cijfer en oordeel. Vanaf Starter, leeg op Free.
planRequiredstring
Abonnement dat de vergrendelde velden bevat. Ontbreekt vanaf Starter.
results[].ipstring
Gecontroleerd IP-adres.
results[].portinteger
Poort uit de invoer, als die er was.
results[].scoreinteger | null
Zuiverheidsscore van 0 tot 100. Vanaf Starter, null op Free.
results[].gradestring | null
S+, S, A, B of C. Vanaf Starter, null op Free.
results[].verdictstring | null
clean, suspect of dirty. Vanaf Starter, null op Free.
results[].classificationstring
residential_clean, mobile, hosting, datacenter, vpn, residential_proxy, tor, relay of unknown.
results[].confidencenumber
Betrouwbaarheid van 0 tot 1.
results[].anonymizedboolean
true als het netwerk de persoon erachter verbergt. Hosting telt mee, behalve bekende infrastructuur.
results[].vpnProviderstring | null
VPN-dienst van een vpn-adres (NordVPN, Mullvad...), indien bekend. Vanaf Starter, null op Free.
results[].isTorExitboolean
true voor Tor-exitnodes.
results[].inVpnRangeboolean
true als het IP in een bekende VPN-range valt.
results[].inDatacenterRangeboolean
true als het IP in een bekende datacenterrange valt.
results[].deductionsarray | null
Aftrekpunten op de score, elk met een reden. Vanaf Starter, null op Free.
results[].lockedstring[]
Velden van deze rij die op dit abonnement als null worden verzonden. Ontbreekt vanaf Starter.

curl -X POST https://ipscanner.io/v1/bulk/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips":["185.220.101.1","24.48.0.1:8080"]}'

Antwoord

{
  "submitted": 2,
  "unique": 2,
  "duplicates": 0,
  "invalid": [],
  "summary": {
    "clean": 1,
    "dirty": 1
  },
  "results": [
    {
      "input": "185.220.101.1",
      "ip": "185.220.101.1",
      "score": 0,
      "grade": "C",
      "verdict": "dirty",
      "classification": "tor",
      "confidence": 0.95,
      "anonymized": true,
      "vpnProvider": null,
      "isTorExit": true,
      "inVpnRange": false,
      "inDatacenterRange": false,
      "asn": "AS60729",
      "asnName": "Stiftung Erneuerbare Freiheit",
      "country": "DE",
      "deductions": [
        {
          "factor": "network_origin",
          "points": 98,
          "detail": "tor at high confidence"
        }
      ]
    },
    {
      "input": "24.48.0.1:8080",
      "ip": "24.48.0.1",
      "port": 8080,
      "score": 88,
      "grade": "S",
      "verdict": "clean",
      "classification": "residential_clean",
      "confidence": 0.3,
      "anonymized": false,
      "vpnProvider": null,
      "isTorExit": false,
      "inVpnRange": false,
      "inDatacenterRange": false,
      "asn": "AS5769",
      "asnName": "VIDEOTRON",
      "country": "CA",
      "deductions": [
        {
          "factor": "no_corroboration",
          "points": 8,
          "detail": "no observation on record for this IP"
        }
      ]
    }
  ]
}

Een lijst streamen

POST/v1/ip/bulk

API-sleutelNDJSON

Parameters

ipsstring[]
Adressen, optioneel met poort. Stuur dit of input.
inputstring
Geplakte tekst; de server vindt de adressen erin.

Antwoordvelden

typestring
meta, result, error of done.
indexinteger
Positie van het adres in de ontdubbelde lijst, vanaf 0.
ipstring
Gecontroleerd IP-adres.
verdictstring | null
clean, suspect of dirty. Vanaf Starter, null op Free.
classificationstring
residential_clean, mobile, hosting, datacenter, vpn, residential_proxy, tor, relay of unknown.
scoreinteger | null
Zuiverheidsscore van 0 tot 100. Vanaf Starter, null op Free.
gradestring | null
S+, S, A, B of C. Vanaf Starter, null op Free.
vpnProviderstring | null
VPN-dienst van een vpn-adres, ontbreekt indien onbekend. Vanaf Starter, null op Free.
lockedstring[]
Resultaatregels: velden die op dit abonnement als null worden verzonden. Ontbreekt vanaf Starter.
planRequiredstring
Metaregel: abonnement dat de vergrendelde velden bevat. Ontbreekt vanaf Starter.
reasonstring
Bij error: invalid_ip of reserved. Bij done: complete of quota_exceeded.
processedinteger
Bij done: gecontroleerde adressen.
failedinteger
Bij done: adressen die niet gecontroleerd konden worden.
totalinteger
Bij meta en done: unieke adressen in het verzoek.

curl -X POST -N https://ipscanner.io/v1/ip/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips":["185.220.101.1","24.48.0.1","10.0.0.1"]}'

Antwoord, één JSON-object per regel

{"type":"meta","total":3,"metered":3}
{"type":"result","ip":"185.220.101.1","verdict":"dirty","classification":"tor","confidence":0.95,"anonymized":true,"score":0,"grade":"C","isTorExit":true,"asn":"AS60729","country":"DE"}
{"type":"result","index":1,"ip":"24.48.0.1","verdict":"clean","classification":"residential_clean","confidence":0.3,"score":88,"grade":"S","asn":"AS5769","country":"CA"}
{"type":"error","index":2,"input":"10.0.0.1","reason":"reserved","message":"private address"}
{"type":"done","reason":"complete","total":3,"processed":2,"failed":1}