Inspect Scout Following Evidence

GET

api

admin

trending

accounts

{account}

scout-followings

Inspect Scout Following Evidence

curl --request GET \
  --url https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "target": {
      "twitterUserId": "2096234819822694499",
      "handle": "exampletarget",
      "displayUsername": "ExampleTarget",
      "displayName": "Example Target",
      "followersCount": 9000,
      "profileRefreshedAt": "2026-09-08T12:00:00Z",
      "profileExpiresAt": "2026-09-15T12:00:00Z",
      "profileIsStale": false
    },
    "summary": {
      "trackedScoutCount": 0,
      "activeScoutCount": 0,
      "inactiveScoutCount": 0,
      "baselineActiveScoutCount": 0,
      "firstNewFollowDetectedAt": null,
      "latestNewFollowDetectedAt": null,
      "latestFollowingSeenAt": null,
      "latestScoutSyncAt": null
    },
    "windows": {
      "1h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "3h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "6h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "24h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "7d": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      }
    },
    "scouts": []
  }
}

Requires an authenticated admin session (cookie or Bearer session token), not a public API key. Read-only: does not query Twitter, refresh profiles, or trigger ranking. Returns 403 for non-admin users and 404 when no evidence is stored. These are observed relationships, not exact Twitter follow timestamps. Baseline means the follow already existed at first sync; its original time is unknown. Meeting the Scout minimum alone does not guarantee a Trending position.

Parameters

string

required

Twitter user ID or handle, optionally prefixed with @. An explicit @ always selects a handle, including all-digit handles; bare numeric input selects a Twitter user ID. Handles require a stored profile; use the numeric ID when the profile is missing.

Response

object

Stored profile: twitterUserId, handle, displayUsername, displayName, followersCount, profileRefreshedAt, profileExpiresAt and profileIsStale. Missing profile values are null.

object

trackedScoutCount, activeScoutCount, inactiveScoutCount, baselineActiveScoutCount, firstNewFollowDetectedAt, latestNewFollowDetectedAt, latestFollowingSeenAt and latestScoutSyncAt. Timestamps are ISO 8601 or null.

object

1h, 3h, 6h, 24h and 7d. Each contains newScoutFollowCount and meetsMinimumScoutCount. Active, non-baseline relationships observed within the window are counted; the minimum is 2 Scouts.

object[]

Each relationship includes scoutAccountId, twitterUserId, handle, displayUsername, displayName, source, enabled, syncSuspended, lastFollowingSyncAt, lastFollowingSyncStatus, followingSyncConsecutiveFailures, detectedAt, lastSeenAt, active, isBaseline and observedInWindows. For baseline rows, detectedAt is a sentinel (2000-01-01), not an actual follow date. active reflects the latest stored observation, not a live Twitter check.

{
  "success": true,
  "data": {
    "target": {
      "twitterUserId": "2096234819822694499",
      "handle": "exampletarget",
      "displayUsername": "ExampleTarget",
      "displayName": "Example Target",
      "followersCount": 9000,
      "profileRefreshedAt": "2026-09-08T12:00:00Z",
      "profileExpiresAt": "2026-09-15T12:00:00Z",
      "profileIsStale": false
    },
    "summary": {
      "trackedScoutCount": 0,
      "activeScoutCount": 0,
      "inactiveScoutCount": 0,
      "baselineActiveScoutCount": 0,
      "firstNewFollowDetectedAt": null,
      "latestNewFollowDetectedAt": null,
      "latestFollowingSeenAt": null,
      "latestScoutSyncAt": null
    },
    "windows": {
      "1h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "3h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "6h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "24h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "7d": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      }
    },
    "scouts": []
  }
}

Inspect Scout Following Evidence

curl --request GET \
  --url https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.openbits.ai/api/v1/admin/trending/accounts/{account}/scout-followings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "target": {
      "twitterUserId": "2096234819822694499",
      "handle": "exampletarget",
      "displayUsername": "ExampleTarget",
      "displayName": "Example Target",
      "followersCount": 9000,
      "profileRefreshedAt": "2026-09-08T12:00:00Z",
      "profileExpiresAt": "2026-09-15T12:00:00Z",
      "profileIsStale": false
    },
    "summary": {
      "trackedScoutCount": 0,
      "activeScoutCount": 0,
      "inactiveScoutCount": 0,
      "baselineActiveScoutCount": 0,
      "firstNewFollowDetectedAt": null,
      "latestNewFollowDetectedAt": null,
      "latestFollowingSeenAt": null,
      "latestScoutSyncAt": null
    },
    "windows": {
      "1h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "3h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "6h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "24h": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      },
      "7d": {
        "newScoutFollowCount": 0,
        "meetsMinimumScoutCount": false
      }
    },
    "scouts": []
  }
}

Overview

Users

Timelines

Social Graph

Tweets

Communities

Lists

Bulk Export

Admin Diagnostics

Admin

Discovery

Inspect Scout Following Evidence

Parameters

Response