Skip to main content

ReportPage

Slim report payload for fast first paint. Aggregated previews live at the root; per-network profile rows omit heavy embedded lists. Use GET /report/{reportId}/full for the full monolithic ReportItem[] shape.

profiles object[]required
  • Array [
  • imagestringrequired
    idProfileId (string)

    id of profile

    usernamestringrequired
    fullnamestringrequired
    imageNotLoadedboolean
    sourceSource (string)required

    source social network of profile

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

    Default value: tw
    linkstringrequired
    categoriesCountinteger<uint16>required
    totalInterestsinteger<uint16>required
    topInterests object[]required
  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
  • ]
  • ]
  • highlights objectrequired
    topCategories object[]required

    Merged top category spots for the highlights strip (matches web client ordering).

    Possible values: <= 5

  • Array [
  • idstringrequired
    namestringrequired
    sharenumber<float>required
    relativenumber<float>required
    sourceSource (string)required

    source social network of profile

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

    Default value: tw
  • ]
  • topInterests object[]required

    Merged top interests for the highlights strip (avatars + links).

    Possible values: <= 12

  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)required

    source social network of profile

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

    Default value: tw
    follows object[]required

    preview of profiles this interest based on

  • Array [
  • imagestringrequired
    idProfileId (string)

    id of profile

    usernamestring
    fullnamestring
    imageNotLoadedboolean
  • ]
  • redCatIdInterestId (string)

    id of interest

    categoryNamestringrequired
    categoryIdstringrequired

    Parent category id (taxonomy) for red-zone list matching

  • ]
  • redzoneInterests object[]required

    Interests with a red-zone flag for the highlights strip.

  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)required

    source social network of profile

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

    Default value: tw
    follows object[]required

    preview of profiles this interest based on

  • Array [
  • imagestringrequired
    idProfileId (string)

    id of profile

    usernamestring
    fullnamestring
    imageNotLoadedboolean
  • ]
  • redCatIdInterestId (string)

    id of interest

    categoryNamestringrequired
    categoryIdstringrequired

    Parent category id (taxonomy) for red-zone list matching

  • ]
  • selectedProfiles object[]

    Present only for reports built from a phone-search confirm flow: the profiles the user selected/confirmed per network. Unmasked unless selectedProfilesMasked is true. Its presence (not a separate flag) is how clients recognise a phone report, since the report page never calls GET /create/{reportId}.

  • Array [
  • sourceSource (string)required

    source social network of profile

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

    Default value: tw
    idProfileId (string)required

    id of profile

    usernamestringrequired

    Real, unmasked username.

    fullnamestringrequired

    Real, unmasked full name.

    imagestringrequired

    Real avatar URL, or "" when unavailable.

    linkstringrequired

    Real profile link, or "" when unavailable.

    isReportSubjectbooleanrequired

    True for the one account per network the report is built from.

    unavailableReasonProfileBadReason (string)

    Possible values: [unloaded, unmapped, zeroFollows, private, notFound, optOut, unexpected]

  • ]
  • selectedProfilesMaskedboolean

    True when selectedProfiles carries shape-preserving masks instead of real identities: the owner confirmed a selection but the credit was not spent. Clients must not infer this from the values themselves. Mirrors ProfilesPage.blurred, the flag the creation wizard already uses for this state.

    buildStatestring

    Present only on a phone-search report page that carries no buildable source. pending - at least one source is still loading (unloaded, with no error recorded); unavailable - every source is terminal, so no report will ever be built. Absent means the ordinary case, where the page carries a report. Optional by design, so the required list is untouched and no existing consumer breaks.

    Possible values: [pending, unavailable]

    friendsPreview object

    Unified merged first page of friends across connected sources (same ordering as GET /report/{reportId}/friends).

    items object[]required
  • Array [
  • imagestringrequired
    idProfileId (string)

    id of profile

    usernamestringrequired
    fullnamestringrequired
    imageNotLoadedboolean
    sourceSource (string)required

    source social network of profile

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

    Default value: tw
    linkstringrequired
    countinteger<uint16>required
    redFlagsCountinteger<uint16>
  • ]
  • hasMorebooleanrequired
    totalinteger<uint32>required
    sourceProfile object
    imagestringrequired
    idProfileId (string)

    id of profile

    usernamestringrequired
    fullnamestringrequired
    imageNotLoadedboolean
    sourceSource (string)required

    source social network of profile

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

    Default value: tw
    linkstringrequired
    sortByRedFlagsDefaultboolean
    sortByRedFlagsboolean

    Sort order used to get this page

    hasCommonInterestsboolean

    Whether there are any friends with common interests available

    hasRedFlagsboolean

    Whether there are any friends with red flags available

    sortByRedFlagsAdjustedboolean

    True when the server used a different sort than requested for this page because the requested list was empty while the alternate list had friends (first page / offset 0 only). Clients should align stored sort with sortByRedFlags and avoid a second request.

    availableSourcesSource (string)[]

    Sources on which this report has at least one friend (common interests and/or red-flags list). For the friends filter; avoids loading the full report for this list.

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

    interestDiffs object

    Merged month buckets of interest adds/removals across sources (preview).

    items object[]required
  • Array [
  • datestring<date>required

    Date in YYYY-MM format

    new object[]required
  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
  • ]
  • lost object[]required
  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
  • ]
  • totalNewinteger<uint32>required

    Total count of new interests for this date

    totalLostinteger<uint32>required

    Total count of lost interests for this date

  • ]
  • redFlags object[]

    Aggregated red-flag interests for quick navigation (subset of highlights red-zone data).

  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
  • ]
  • interestCategoriesPreview object[]

    Per-source truncated category trees for the interests section initial render.

  • Array [
  • sourceSource (string)required

    source social network of profile

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

    Default value: tw
    categories object[]required

    Truncated category tree for this source (first interests only); full trees via GET /report/{reportId}/interests.

  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
    interests object[]required
  • Array [
  • idInterestId (string)required

    id of interest

    namestringrequired
    sharenumber<float>required

    share of this interest for this profile

    relativenumber<float>required

    relativeWeight of this interest for this profile

    unactiveboolean

    When true, this interest is not clickable in the interest-diffs preview or paginated diff list (e.g. new interests UI).

    categorystring

    Red-flag bucket label (e.g. Adult, Violence). Real (non-synthetic) parent category name for display badges.

    sourceSource (string)

    source social network of profile

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

    Default value: tw
    follows object[]required

    preview of profiles this interest based on

  • Array [
  • imagestringrequired
    idProfileId (string)

    id of profile

    usernamestring
    fullnamestring
    imageNotLoadedboolean
  • ]
  • redCatIdInterestId (string)

    id of interest

  • ]
  • ]
  • ]
  • publicboolean
    bluredReportBlured (string)

    Possible values: [unregistered, unconfirmed, unsubscribed, needupgrade]

    trackedinteger<uint32>
    userIdstring

    id of user who owns the report

    boi object

    Present when the owner has ordered a Book of Insta add-on for this report. Served to the owner only.

    createdAtstring<date-time>required

    When the Book of Insta add-on was ordered

    usernamestringrequired

    Instagram username the Book of Insta report was ordered for

    userIdstringrequired

    SocialProfiler user id that paid for the add-on

    ReportPage
    {
    "profiles": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true,
    "source": "tw",
    "link": "string",
    "categoriesCount": 0,
    "totalInterests": 0,
    "topInterests": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw"
    }
    ]
    }
    ],
    "highlights": {
    "topCategories": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "source": "tw"
    }
    ],
    "topInterests": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw",
    "follows": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true
    }
    ],
    "redCatId": "string",
    "categoryName": "string",
    "categoryId": "string"
    }
    ],
    "redzoneInterests": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw",
    "follows": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true
    }
    ],
    "redCatId": "string",
    "categoryName": "string",
    "categoryId": "string"
    }
    ]
    },
    "selectedProfiles": [
    {
    "source": "tw",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "image": "string",
    "link": "string",
    "isReportSubject": true,
    "unavailableReason": "unloaded"
    }
    ],
    "selectedProfilesMasked": true,
    "buildState": "pending",
    "friendsPreview": {
    "items": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true,
    "source": "tw",
    "link": "string",
    "count": 0,
    "redFlagsCount": 0
    }
    ],
    "hasMore": true,
    "total": 0,
    "sourceProfile": {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true,
    "source": "tw",
    "link": "string"
    },
    "sortByRedFlagsDefault": true,
    "sortByRedFlags": true,
    "hasCommonInterests": true,
    "hasRedFlags": true,
    "sortByRedFlagsAdjusted": true,
    "availableSources": [
    "tw"
    ]
    },
    "interestDiffs": {
    "items": [
    {
    "date": "2024-07-29",
    "new": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw"
    }
    ],
    "lost": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw"
    }
    ],
    "totalNew": 0,
    "totalLost": 0
    }
    ]
    },
    "redFlags": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw"
    }
    ],
    "interestCategoriesPreview": [
    {
    "source": "tw",
    "categories": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw",
    "interests": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw",
    "follows": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true
    }
    ],
    "redCatId": "string"
    }
    ]
    }
    ]
    }
    ],
    "public": true,
    "blured": "unregistered",
    "tracked": 0,
    "userId": "string",
    "boi": {
    "createdAt": "2024-07-29T15:51:28.071Z",
    "username": "string",
    "userId": "string"
    }
    }