Skip to main content

SearchResultsResponse

searchIdstringrequired

Search task ID

thumbnailstring<uri>required

Thumbnail of the uploaded photo used for search

createdAtstring<date-time>

When the search was created

statusSearchStatus (string)

Search processing status

Possible values: [processing, completed, error, preview]

consensusNamestringrequired

Consensus name from backend (aggregated from all profiles of this person)

profiles object[]required

Array of social network profiles for the matched person (unblurred information)

  • Array [
    • sourceSource (string)required

    Social network source identifier

    Possible values: [fb, ig, tt, tw]

    Example: fb
    usernamestringrequired

    Username on the social network

    fullnamestring

    Full name of the user on the social network

    profilePicturestring<uri>

    Profile picture URL for this social network

    biostring

    User bio from this social network

    profileUrlstring<uri>

    Profile URL for this social network

    isPrivateboolean

    Whether the profile is private

    partialNamestring

    Masked name when results are blurred (e.g. "****"). Used with isBlurred on parent response.

    removedByRequestboolean

    When true, this profile slot was removed by an opt-out request and only a placeholder is shown.

  • ]
    • notificationEnabledbooleanrequired

    Whether notifications are enabled for new matches

    isBlurredboolean

    When true, profile data (names, usernames, bio, links) is masked; user must subscribe to see full results.

    socialprofilerData objectnullable

    Social Profiler report data. Included only if getSocialprofiler=true query parameter was provided and the report is ready (status is "completed"). Otherwise, this field is null/empty.

    statusSocialProfilerStatus (string)required

    Social Profiler report generation status

    Possible values: [loading, completed, error]

    idstring

    Profile ID

    usernamestring

    Profile username

    fullnamestring

    Profile full name

    imagestring<uri>

    Profile picture URL

    sourceSource (string)

    Social network source identifier

    Possible values: [fb, ig, tt, tw]

    Example: fb
    linkstring<uri>

    Profile URL

    reportUrlstring<uri>

    Link to the Social Profiler report in the dashboard; includes ?h={encodedEmail} when available

    totalInterestsinteger<uint16>

    Total number of interests

    totalFriendsinteger<uint32>

    Total number of friends

    totalRedFlagsinteger<uint16>

    Real total count of red-flag interests across all profiles (pills in redFlags are capped at 5).

    totalCategoriesinteger<uint16>

    Real total count of interest categories across all profiles (pills in categories are capped at 5).

    topInterests object[]

    Top interests with share percentages

  • Array [
    • namestringrequired

    Interest name

    shareinteger<uint8>required

    Share percentage (0-100)

    sourceSource (string)

    Social network source identifier

    Possible values: [fb, ig, tt, tw]

    Example: fb
  • ]
    • categories object[]

    Interest categories with share percentages

  • Array [
    • namestringrequired

    Interest name

    shareinteger<uint8>required

    Share percentage (0-100)

    sourceSource (string)

    Social network source identifier

    Possible values: [fb, ig, tt, tw]

    Example: fb
  • ]
    • redFlags object[]

    Red flag interests with detailed information

  • Array [
    • idstringrequired

    Interest ID

    namestringrequired

    Interest name

    sharenumber<float>required

    Share of this interest for this profile

    relativenumber<float>required

    Relative weight of this interest for this profile

    categorystring

    Red-flag bucket label (e.g. Adult, Violence)

  • ]
    • friends object[]

    Mutual friends with common interests count

  • Array [
    • idstringrequired

    Friend profile ID

    usernamestringrequired

    Friend username

    fullnamestringrequired

    Friend full name

    imagestring<uri>required

    Friend profile picture URL

    sourceSource (string)required

    Social network source identifier

    Possible values: [fb, ig, tt, tw]

    Example: fb
    linkstring<uri>required

    Friend profile URL

    countinteger<uint16>required

    Number of common interests

    redFlagsCountinteger<uint16>

    Number of red-flag interests this friend has

  • ]
    • promoSchemaVersioninteger<uint8>

    Promo wire schema version. Absent in responses means pre-v2 unversioned payload; consumers should treat absence as 1.

    Default value: 1
    read_onlyboolean

    When true, the current user is an admin viewing another user's search; UI should be read-only (no select/delete/actions).

    SearchResultsResponse
    {
      "searchId": "67489a2b3f4a210002",
      "thumbnail": "https://cdn.face2social.com/uploads/67489a2b3f4a210002_thumb.jpg",
      "createdAt": "2025-11-28T14:30:00Z",
      "status": "completed",
      "consensusName": "Oliver Black",
      "profiles": [
        {
          "source": "fb",
          "username": "oliver.black",
          "profilePicture": "https://cdn.face2social.com/profiles/match_001_fb.jpg",
          "bio": "Software Engineer | Travel enthusiast",
          "profileUrl": "https://facebook.com/oliver.black",
          "isPrivate": false
        },
        {
          "source": "ig",
          "username": "oblack_official",
          "profilePicture": "https://cdn.face2social.com/profiles/match_001_ig.jpg",
          "bio": "Software Engineer | Travel enthusiast | Photography",
          "profileUrl": "https://instagram.com/oblack_official",
          "isPrivate": true
        }
      ],
      "notificationEnabled": true,
      "socialprofilerReady": false
    }