Documentação da API

Parâmetros

Exemplo de Resposta

{
  "host": "8.8.8.8",
  "resolvedIp": "8.8.8.8",
  "count": 4,
  "sent": 4,
  "received": 4,
  "packetLoss": 0,
  "latency": {
    "min": 1.23,
    "avg": 2.45,
    "max": 3.67,
    "jitter": 0.89
  },
  "rtts": [1.23, 2.45, 3.67, 2.45],
  "family": 4
}

Parâmetros

Exemplo de Resposta

{
  "domain": "example.com",
  "type": "A",
  "records": [
    { "address": "93.184.216.34", "ttl": 300 }
  ],
  "queryTime": 12.34,
  "server": "cloudflare",
  "servers": ["1.1.1.1", "1.0.0.1"]
}

Parâmetros

Exemplo de Resposta

{
  "url": "https://example.com",
  "reachable": true,
  "failure": null,
  "statusCode": 200,
  "statusText": "OK",
  "responseTime": 145,
  "redirects": [],
  "headers": {
    "content-type": "text/html; charset=UTF-8",
    "server": "nginx"
  },
  "ssl": {
    "valid": true,
    "problem": null,
    "problemCode": null,
    "issuer": "DigiCert Inc",
    "validFrom": "2026-01-01",
    "validTo": "2027-01-01",
    "daysRemaining": 180,
    "protocol": "TLSv1.3",
    "sans": ["example.com", "www.example.com"]
  },
  "security": {
    "grade": "B",
    "score": 75,
    "findings": [
      { "key": "strict-transport-security", "present": true,
        "value": "max-age=31536000", "status": "ok" },
      { "key": "content-security-policy", "present": false,
        "value": null, "status": "missing" }
    ]
  },
  "resolvedIp": "93.184.216.34",
  "family": 4
}

Falha do certificado (HTTP 200)

{
  "url": "https://expired.example.com",
  "reachable": false,
  "failure": {
    "code": "CERT_HAS_EXPIRED",
    "message": "The certificate has expired."
  },
  "statusCode": null,
  "ssl": {
    "valid": false,
    "problemCode": "CERT_HAS_EXPIRED",
    "validTo": "2026-01-01",
    "daysRemaining": -267
  },
  "security": null
}

Parâmetros

Exemplo de Resposta

{
  "host": "example.com",
  "resolvedIp": "93.184.216.34",
  "family": 4,
  "port": 443,
  "state": "open",
  "open": true,
  "responseTime": 23,
  "service": "HTTPS"
}

Parâmetros

Exemplo de Resposta

{
  "ip": "8.8.8.8",
  "reputation": "clean",
  "score": 0,
  "listsAnswered": 5,
  "listsQueried": 5,
  "abuseipdb": {
    "status": "ok",
    "score": 0,
    "totalReports": 0,
    "reportsWindowDays": 90,
    "lastReported": "2025-05-20T22:08:09Z"
  },
  "blacklists": [
    { "name": "Spamhaus ZEN", "status": "clean", "listed": false },
    { "name": "SpamCop", "status": "clean", "listed": false },
    { "name": "Barracuda", "status": "unavailable", "listed": false, "reason": "no_answer" }
  ],
  "geo": {
    "country": "US",
    "isp": "Google LLC",
    "org": "Google LLC",
    "as": "AS15169 Google LLC"
  }
}

Parâmetros

Exemplo de Resposta

{
  "query": "1.1.1.1",
  "kind": "ip",
  "domain": null,
  "ip": "1.1.1.1",
  "addresses": [
    "1.1.1.1"
  ],
  "hostname": "one.one.one.one",
  "network": {
    "asn": 13335,
    "asName": "Cloudflare, Inc.",
    "org": "APNIC Research and Development",
    "netName": "APNIC-LABS",
    "netRange": "1.1.1.0/24",
    "registry": "whois.apnic.net",
    "abuse": "helpdesk@apnic.net"
  },
  "location": {
    "city": "Brisbane",
    "region": "Queensland",
    "country": "Australia",
    "countryCode": "AU"
  },
  "routing": {
    "prefix": "1.1.1.0/24",
    "announced": true,
    "coveringPrefix": null,
    "originAsn": 13335,
    "originHolder": "CLOUDFLARENET - Cloudflare, Inc.",
    "rpki": "valid",
    "upstreams": [
      {
        "asn": 24482,
        "holder": "SGGS-AS-AP - SG.GS",
        "paths": 9
      },
      {
        "asn": 199524,
        "holder": "GCORE G-Core Labs S.A.",
        "paths": 7
      }
    ],
    "collectorCount": 22
  },
  "reputation": {
    "verdict": "clean",
    "score": 0,
    "listedOn": [],
    "listsAnswered": 5,
    "listsQueried": 5,
    "abuseipdbScore": 0,
    "reports": 169,
    "reportsWindowDays": 90,
    "whitelisted": true
  },
  "gaps": [],
  "generatedAt": "2026-10-25T14:47:04.261Z"
}

Parâmetros

Exemplo de Resposta

{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "org": "Google LLC",
  "netName": "GOGL",
  "netRange": "8.8.8.0/24",
  "country": "US",
  "countrySource": "geoip",
  "abuse": "network-abuse@google.com",
  "registry": "whois.arin.net",
  "registryUnavailable": false,
  "asn": "AS15169 Google LLC",
  "reserved": false
}

Parâmetros

Exemplo de Resposta

{
  "domain": "tracemapper.com",
  "source": "crtsh",
  "sources": [{ "id": "crtsh", "status": "ok" }],
  "partial": false,
  "subdomains": [
    {
      "name": "tracemapper.com",
      "firstSeen": "2026-08-07T00:00:00.000Z",
      "lastSeen": "2026-11-05T01:22:00.000Z",
      "certificates": 1,
      "wildcard": false
    }
  ],
  "certificates": [],
  "totals": { "subdomains": 3, "wildcards": 1, "certificates": 13 },
  "stale": false,
  "fetchedAt": "2026-09-11T07:20:00.000Z"
}

Parâmetros

Exemplo de Resposta

{
  "domain": "example.com",
  "verdict": "warning",
  "spf": {
    "status": "warning",
    "record": "v=spf1 include:_spf.example.net ~all",
    "lookups": 9,
    "lookupLimit": 10,
    "truncated": false,
    "allQualifier": "~",
    "includes": [{ "domain": "_spf.example.net", "depth": 0, "cost": 9 }],
    "findings": [
      { "code": "spf_lookups_near_limit", "severity": "warning",
        "params": { "count": 9, "limit": 10 } }
    ]
  },
  "dmarc": { "status": "warning", "policy": "none", "rua": ["mailto:d@example.com"], "findings": [] },
  "dkim": { "status": "unknown", "found": [], "selectorsTried": ["default", "google"] },
  "mx": { "status": "ok", "hosts": [{ "host": "mx.example.com", "priority": 10, "resolves": true }] },
  "checkedAt": "2026-09-11T09:30:00.000Z"
}

Parâmetros

Exemplo de Resposta

{
  "status": "ok",
  "events": [
    {
      "id": "1234",
      "locations": [{ "code": "IQ", "name": "Iraq" }],
      "networks": [{ "asn": 203214, "name": "HulumTele" }],
      "cause": "GOVERNMENT_DIRECTED",
      "outageType": "NATIONWIDE",
      "scope": null,
      "description": "Exam Shutdown",
      "startDate": "2026-09-10T03:30:00.000Z",
      "endDate": "2026-09-10T03:45:00.000Z",
      "ongoing": false,
      "linkedUrl": null
    }
  ],
  "totals": { "ongoing": 0, "ended": 5 },
  "dateRange": "7d",
  "stale": false,
  "fetchedAt": "2026-09-11T07:20:00.000Z"
}

Parâmetros

Resposta para um endereço ou um prefixo

{
  "kind": "prefix",
  "target": "8.8.8.8",
  "prefix": "8.8.8.0/24",
  "allocationBlock": "8.0.0.0/8",
  "announced": true,
  "origin": { "asn": 15169, "holder": "Google LLC" },
  "rpki": "valid",
  "paths": [
    {
      "collector": "rrc00",
      "peer": "80.249.208.1",
      "asPath": [13335, 15169],
      "asPathCollapsed": [13335, 15169],
      "communities": ["13335:10000"]
    }
  ],
  "pathCount": 245,
  "collectorCount": 24,
  "upstreamAsns": [
    { "asn": 13335, "holder": "Cloudflare Inc", "count": 45 }
  ]
}

Resposta para um número de AS (target=AS15169)

{
  "kind": "asn",
  "target": "AS15169",
  "asn": 15169,
  "holder": "GOOGLE - Google LLC",
  "announced": true,
  "prefixCount": 1024,
  "prefixes": ["8.8.8.0/24", "8.8.4.0/24"],
  "prefixesTruncated": true,
  "prefixesUnavailable": false,
  "neighboursUnavailable": false,
  "neighbours": [
    { "asn": 3356, "holder": "LEVEL3", "relation": "upstream" },
    { "asn": 36040, "holder": "YOUTUBE", "relation": "downstream" }
  ]
}

Parâmetros

cURL

# O seu endereço IP público, em texto simples
curl "https://tracemapper.com/api/my-ip?format=text"

# O seu endereço IPv6 (falha se a sua ligação não tiver)
curl "https://ipv6.tracemapper.com/api/my-ip?format=text"

# O mesmo, com operador, ASN e localização aproximada (JSON)
curl "https://tracemapper.com/api/my-ip"

Exemplo de Resposta

{
  "ip": "203.0.113.42",
  "version": 4,
  "private": false,
  "asn": 64496,
  "org": "Example Telecom",
  "city": "Lyon",
  "region": "Auvergne-Rhône-Alpes",
  "country": "France",
  "countryCode": "FR",
  "latitude": 45.75,
  "longitude": 4.85,
  "reverseDns": "host-203-0-113-42.example.net"
}