FSB FSB API DOCS

FSB API

Integrate real-time Twitter reach diagnostics into your bot, CRM, dashboard, or analytics suite. No credit cards, no passwords, and zero API keys required.

Free & Ad-Free
15 req/min
Strict JSON Payload
Interactive Console

Live Endpoint Explorer

Test live against real Twitter/X targets
GET
https://visiuun.com/fsb/?api=
Quick handles:
Ready • -- ms • -- KB
// Click "Send Request" to inspect the live response

Root Endpoints

All requests must be issued over standard HTTPS. Responses are served with application/json encoding.

https://visiuun.com/fsb/?api={username}
https://visiuun.com/fsb/?api&target={username}

Fair Use & Rate Limits

The free tier permits 15 requests per minute per client IP. Response headers keep client clients synchronized with remaining quota:

X-RateLimit-Limit 15
X-RateLimit-Remaining 0 - 15
X-RateLimit-Reset Unix timestamp
Retry-After Seconds to wait (on 429)
Code Samples

Integration Snippets

curl -s -X GET "https://visiuun.com/fsb/?api=elonmusk" \
  -H "Accept: application/json" \
  -H "User-Agent: YourApp/1.0"
Data Contracts

Payload Schema Reference

Descriptions for all entities returned within the data root object.

data.profile

Profile Metadata Object
Field Type Description
username string Handle/screen name without leading `@`.
name string Display name specified on the account profile.
avatar string Authentic HD 400x400 avatar URL hosted on Twitter CDN.
avatar_proxy string CORS-friendly cached avatar proxy URL provided by FSB.
bio string Self-declared profile description.
verified boolean True if account holds X Premium or legacy blue verification badge.
stats object Followers, following, posts count, likes count, and follower-to-following ratio.

data.shadowban

Algorithmic Diagnostics
Field Type Description
is_shadowbanned boolean True if any algorithmic restriction (search, suggestion, ghost, or reply deboost) is active.
status string "Clean" or "Shadowbanned".
health_score integer Composite reach integrity score from 0 to 100.
tests.search_ban object Indicates if tweets are completely hidden from Twitter/X search results.
tests.search_suggestion_ban object Indicates if handle is suppressed from typeahead search suggestions and recommendation feeds.
tests.ghost_ban object Indicates if replies are isolated and hidden from third-party thread observers.
tests.reply_deboosting object Indicates if replies are relegated behind the 'Show more replies' / 'probable spam' demotion barrier.

data.post_intelligence

Timeline Metrics & Outliers
Field Type Description
sample_size integer Count of recent posts evaluated (typically 20 - 40).
engagement_rate_percent float Standardized engagement percentage relative to active followers and views.
link_penalty_exposure_percent float Percentage of posts containing outside links (which trigger algorithmic demotion).
outliers object High-impact posts: `best_performing`, `highest_algorithmic_impact`, `most_discussed`, `lowest_performing`.
HTTP Protocol

Status Codes & Error Handling

200 OK

Successful inspection. Account telemetry and diagnostics returned cleanly.

400 Bad Request

Invalid username format or missing target parameter.

403 Forbidden

Blocked access via cloud proxies, Tor exit nodes, or automated scrapers.

404 Not Found

Account does not exist on Twitter/X, has been deleted, or is suspended.

429 Rate Limit

Hourly rate limit exceeded (15 req/min). Inspect Retry-After header.

502 Bad Gateway

Twitter upstream service is temporarily unreachable or undergoing maintenance.