---
title: "List the sites a username search covers"
method: GET
path: "/usernames/sites"
tags: ["Usernames"]
---

# List the sites a username search covers

`GET /usernames/sites`

## Request

- Base URL: `https://api.socially.run/v1`
- URL: `https://api.socially.run/v1/usernames/sites`
- Auth: HTTP bearer

The site database: what each site is, how it is classified, how much a hit there is worth, and what the nightly check currently thinks of it. Use the ids to scope a search with `sites`.

## Query parameters

- `category` 'archived' | 'art' | 'blog' | 'business' | 'coding' | 'dating' | 'finance' | 'gaming' | 'health' | 'hobby' | 'images' | 'misc' | 'music' | 'news' | 'political' | 'search' | 'shopping' | 'social' | 'tech' | 'video' | 'xx NSFW xx': Only sites in this category.
- `includeNsfw` boolean: Include sites marked as adult in the listing.
- `limit` integer
- `offset` integer

## Response `200`

List the sites a username search covers

- object
  - `data` unknown, required

## Other responses

- `400`: VALIDATION_ERROR / INVALID_TARGET / SSRF_BLOCKED: the issues, never the values.
- `401`: UNAUTHORIZED / INVALID_TOKEN: the key is missing or wrong.
- `402`: PAYMENT_REQUIRED / PLAN_GATE: clears by upgrading or buying credits, never by waiting.
- `429`: RATE_LIMIT_EXCEEDED / QUOTA_EXCEEDED: Retry-After says when it clears.
- `default`: Any other failure.

---

[API](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json.md) · [All operations](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/llms.txt) · [OpenAPI document](https://skmtc.dev/socially/apis/socially-run-send-a-profile-link-get-its-public-data-as-json/revisions/5a0b24534b90?raw)