Skip to content

CandidateProfileModel

PropertyTypeRequiredDescription
idstring (uuid)No
subjectIdstring (uuid)No
platformstringNoValues: Facebook, Instagram, Twitter, LinkedIn, TikTok, Reddit, Pinterest, YouTube.
sourceCandidateProfileSourceNo
handlestringNoNullable.
cityStateCountrystringNoNullable.
ageDOBstringNoNullable.
biostringNoNullable.
profilePhotoUrlstringNoNullable.
profileUrlstringNoNullable.
validationSuccessfulbooleanNoNullable.
isUsedInSubjectbooleanNo
isValidatedbooleanNo
isPersonalProfilebooleanNo
profileImageSimilaritynumber (float)No
profileImageMatchTypeImageMatchTypeNo
confidencenumber (float)No
fullNamesarray of stringNoNullable.
addressesarray of stringNoNullable.
emailsarray of stringNoNullable.
companiesarray of stringNoNullable.
collegesarray of stringNoNullable.
highSchoolsarray of stringNoNullable.
phonesarray of stringNoNullable.
otherNamesarray of stringNoNullable.
identifiersProfileIdentifiersNo
locationCoordinatesNo
searchIterationstringNoRepresents a search iteration step where this candidate came from. Null for non-search (validation) candidates Nullable.
socialMediaProfileIdstringNoRepresents a unique candidate id provided by platform Nullable.
isNotAvailableForHandlebooleanNoA Boolean indicating whether this profile is not available for use as a subject handle. This is typically used for profiles that are found to be duplicates or otherwise unsuitable for handles.
reasoningstringNoLLM reasoning Nullable.

Use only the documented fields.