Matchplat API Docs

POST /explore/autoprofile

Starts an autoprofiling process on an existing PLUS search. Sends results to a specified webhook. The response provides a URL to monitor the autoprofiling status.

Request Body

Field Type Description
searchContextId String PLUS search identifier (GUID format)
webhookUrl String URL (webhook) where autoprofiled data will be sent

Response 200

Field Type Description
monitorUrl String URL to monitor autoprofiling status

WebhookAutoprofileBody

The webhook is called once for each profiled company, as the process progresses. While autoprofile is in progress, you can typically expect 1 or 2 calls per second.

Field Type Description
company Company Autoprofiled company object
matchStatus MatchStatus Match status (YES or MAYBE)
matchReason MatchReason Match reason (IT/EN, AI generated)

MatchStatus (enum)

MatchReason

FieldTypeDescription
it String Reason in Italian
en String Reason in English

MonitorStatusResponse

FieldTypeDescription
status String Process status (QUEUED, IN_PROGRESS, DONE)
startTimestamp DateTime Start timestamp
endTimestamp DateTime|null End timestamp (null if not finished)
eta DateTime|null Estimated completion (null if not available)
companies Company[] Array of autoprofiled companies

Example

{
  "monitorUrl": "https://integrations.matchplat.com/explore/autoprofile/status/123e4567-e89b-12d3-a456-426614174000"
}

Example curl call

curl -X POST "/explore/autoprofile" \
  -H "x-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "searchContextId": "b7e6a2c1-4f3d-4e2a-9c1a-2b3e4d5f6a7b",
    "webhookUrl": "https://webhook.site/your-uuid"
  }'

Other codes