Skip to main content

FullReportResponse

Full monolithic report payload (all ReportItem rows per profile, optional embedded summary). Prefer GET /report/{reportId} for the slim ReportPage; use GET /report/{reportId}/summary for summary only.

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

    Number of interest categories for this profile; full trees via GET /report/{reportId}/interests.

    categories object[]

    Preview of the interest category tree for this profile (same shape as GET /report/{reportId}/interests), truncated to the first 8 interests in display order. Omitted when there are no interests; use the interests endpoint for the complete tree.

  • 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

  • ]
  • ]
  • 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
  • ]
  • friends objectrequired
    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]

    redFlags object[]
  • 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
  • ]
  • interestDiffs object
    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

  • ]
  • ]
  • highlights object
    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

  • ]
  • summary objectdeprecated

    Prefer GET /report/{reportId}/summary.

    statusReportSummaryStatus (string)required

    Possible values: [pending, error, done, not_found]

    Default value: pending
    resultarray[]

    Possible values: >= 2, <= 2

    errorstring
    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

    selectedProfiles object[]

    Present only for reports built from a phone-search confirm flow: the profiles the user selected/confirmed per network, unmasked. 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]

  • ]
  • FullReportResponse
    {
    "profiles": [
    {
    "image": "string",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "imageNotLoaded": true,
    "source": "tw",
    "link": "string",
    "categoriesCount": 0,
    "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"
    }
    ]
    }
    ],
    "totalInterests": 0,
    "topInterests": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "tw"
    }
    ],
    "friends": {
    "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"
    ]
    },
    "redFlags": [
    {
    "id": "string",
    "name": "string",
    "share": 0,
    "relative": 0,
    "unactive": true,
    "category": "string",
    "source": "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
    }
    ]
    }
    }
    ],
    "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"
    }
    ]
    },
    "public": true,
    "blured": "unregistered",
    "tracked": 0,
    "userId": "string",
    "boi": {
    "createdAt": "2024-07-29T15:51:28.071Z",
    "username": "string",
    "userId": "string"
    },
    "selectedProfiles": [
    {
    "source": "tw",
    "id": "string",
    "username": "string",
    "fullname": "string",
    "image": "string",
    "link": "string",
    "isReportSubject": true,
    "unavailableReason": "unloaded"
    }
    ]
    }