Documentation

Introduction

Guide to the Intrace Intelligence API

The Intrace Intelligence API is an API-first OSINT service for customer intelligence workflows. It exposes three capabilities:

  • Web search for normalized web, news, and supported public social/adverse-media hits.
  • PII expansion for expanding email, phone, and username identifiers into identifier-only identity candidates.
  • Social Profile Analysis for analyzing known social profile URLs. The base Match layer returns matching records from those profiles; optional Behavioral Analysis explains patterns, escalation, risk signals, and target-context relevance.

All capability responses are normalized, deduplicated, and shaped for API consumption. Web/adverse-media results include resultUrl so investigators can review the underlying page. PII expansion focuses on normalized identifier candidates. Social Profile Analysis is evidence-first and does not discover or score candidate profiles.

Base URL

The production Intelligence API endpoint is:

https://api.ie.intrace.ai/

Capability endpoints are served under /v1:

POST https://api.ie.intrace.ai/v1/web-search
POST https://api.ie.intrace.ai/v1/pii-expansion
POST https://api.ie.intrace.ai/v1/social-profile-analysis

Operational health endpoints are exposed at https://api.ie.intrace.ai/healthz and https://api.ie.intrace.ai/readyz.

Access patterns

Each capability supports the same three patterns:

  1. Inline REST: POST /v1/<capability> with responseMode: "sync".
  2. Async jobs: POST /v1/<capability> with responseMode: "async", then poll the returned resultUrl.
  3. Server-sent events: POST /v1/<capability>/stream for progress and result events.

See the API Reference for exact request and response schemas. The reference is generated from the implemented API contract.