Professional API

See the data structure before you subscribe

Build filtered, aggregate research queries with a Professional subscription and your own API key.

Illustrative request URL Example only — this address cannot run

A developer-friendly request shape

https://api.example.invalid/relationwatch/v1/analytics?
api_key=VAR_API_KEY&country=USA&year=VAR_YEAR&
incident_type=VAR_INCIDENT_TYPE&relationship_status=VAR_RELATIONSHIP_STATUS&
include=motives,red_flags,contributing_factors,outcomes

api_key Your private key country e.g. USA year e.g. 2025 incident_type Selected incident type relationship_status Recorded relationship include Requested data groups

Illustrative JSON response Example values only

What a response can look like

{
  "example": true,
  "filters": {
    "country": "USA",
    "year": "VAR_YEAR",
    "incident_type": "VAR_INCIDENT_TYPE"
  },
  "results": {
    "public_case_count": "VAR_COUNT",
    "motives": [{"label": "VAR_LABEL", "count": "VAR_COUNT"}],
    "red_flags": [{"label": "VAR_LABEL", "count": "VAR_COUNT"}],
    "outcomes": [{"label": "VAR_LABEL", "count": "VAR_COUNT"}]
  }
}

See the data structure before you subscribe

A developer-friendly request shape

What a response can look like

Ready to connect your research tools?