VIRUSSIGN
DEVELOPER RESOURCES / API V1

URL intelligence

Reference URL identifiers, host information, HTTP observations and threat assessments.

This reference covers the indicator object in a lookup response. See request parameters, response metadata and response conventions. Pro fields provide additional context where available; compact views contain fewer fields.

Fields are conditional unless stated otherwise. Types below describe populated values; optional values may also be null. Access labels describe capability, not guaranteed data for every indicator.

URL fields

indicator
Fields in indicator
FieldTypeMeaning
typestringURL record.
valuestringOpaque URL identifier. Reuse it for URL relationship requests; do not reconstruct it.
analysisobjectThreat assessment. Field reference →
first_seenstringFirst observation time. ISO 8601 timestamp with timezone.
last_seenstringLatest observation time. ISO 8601 timestamp with timezone.
tagsarray<string>Descriptive indicator labels.
crowd_contextobject · ProCommunity and actor context, where available. Field reference →
relationsobjectRelated object groups when requested with full+relations and authorized. See Relationships. Field reference →
urlstringComplete URL represented by the record.
hoststringURL hostname.
tldstring · ProPublic suffix or top-level domain.
indicator.contextobject

Context for an object returned through a relationship.

Fields in indicator.context
FieldTypeMeaning
relationshipstringRelationship connecting this object to the source indicator.
indicator.httpobject · Pro

Observed HTTP response details.

Fields in indicator.http
FieldTypeMeaning
status_codeintegerObserved response status code.
content_lengthintegerObserved response content length in bytes.
content_sha256stringSHA-256 of the observed response body.

Illustrative response

Illustrative data showing the response structure. Optional fields may be omitted.

JSON · illustrative urls
{
  "meta": {
    "request_id": "example-request",
    "timestamp": "2026-01-15T12:00:00Z",
    "quota_remaining": 100,
    "took_ms": 12
  },
  "indicator": {
    "type": "url",
    "value": "aacc00f0518c9ab0a5c8a40a721eb816ba18db020c7d32e20f3b53a82c3d30ca",
    "url": "https://beacon.example/path",
    "host": "beacon.example",
    "analysis": {
      "malicious": true,
      "severity": "medium",
      "confidence": 60,
      "detections": "28/32",
      "family": "ExampleFamily",
      "has_actor": false
    },
    "crowd_context": {
      "misc_tags": [
        "dropper"
      ]
    },
    "http": {
      "status_code": 200,
      "content_length": 512,
      "content_sha256": "dacad43e2e6da5595622be3857f80e13d69c94d24b700ede8a2881e3ae42b36c"
    },
    "first_seen": "2026-01-15T12:00:00Z",
    "last_seen": "2026-01-15T12:00:00Z"
  }
}

Files are hashed locally in your browser and never uploaded. Only the SHA-256 is sent for lookup. Standard query quota applies.