---
title: "Check social handles"
method: POST
path: "/api/v1/check/social"
tags: ["Check"]
---

# Check social handles

`POST /api/v1/check/social`

## Request

- Base URL: `https://namesniper.pro`
- URL: `https://namesniper.pro/api/v1/check/social`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `platforms` PlatformName[]: Defaults to every supported platform (Telegram must be requested explicitly). Unknown ids return 400 with the valid list.

## Response `200`

Social availability results.

- object
  - `success` unknown
  - `data` object
    - `name` string
    - `username` string
    - `results` CheckResult[]
      - `platform` 'youtube' | 'tiktok' | 'instagram' | 'twitter' | 'github' | 'npm' | 'twitch' | 'threads' | 'bluesky' | 'pinterest' | 'snapchat' | 'kick' | 'linktree' | 'roblox' | 'telegram', required
      - `username` string, required
      - `available` boolean, required
      - `confidence` number, required: Confidence in the verdict, 0 to 1.
      - `error` string
      - `invalid` boolean: Username violates the platform's format rules and can never be registered there.
      - `loginWallDetected` boolean
      - `botDetected` boolean
      - `checkedAt` string, date-time, required
      - `url` string, uri, required
    - `summary` CheckSummary
      - `totalChecks` integer
      - `available` integer
      - `taken` integer
      - `errors` integer
      - `uncertain` integer: Checks that got no verdict either way (low confidence or errored). Social checks only.
  - `meta` Meta: Standard response metadata.
    - `plan` 'guest' | 'free' | 'day_pass' | 'sniper' | 'pro' | 'business'
    - `duration` integer: Server processing time in milliseconds.
    - `timestamp` string, date-time

## Other responses

- `400`: Invalid request (missing field, bad JSON, or invalid value).
- `401`: Missing or invalid API key.
- `429`: Rate limit or daily quota exceeded. Inspect the `Retry-After` header for how many seconds to wait. Limits are per account, so every key on the account shares them.

---

[API](https://skmtc.dev/namesniper/apis/namesniper-api.md) · [All operations](https://skmtc.dev/namesniper/apis/namesniper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namesniper/apis/namesniper-api/revisions/fd6bfd6608b2?raw)