---
title: "Connected Socials"
method: POST
path: "/public/v1/creators/socials/"
tags: ["Connected Socials"]
---

# Connected Socials

`POST /public/v1/creators/socials/`

Discover all verified social accounts connected to a creator, given a seed platform and handle.

**What you get**

- Returns an array of verified connected social accounts across platforms, including platform name, username, and follower count for each connected account.
- Supports 6 seed platforms: Instagram, YouTube, TikTok, OnlyFans, Twitter, and Twitch.

**Credits**

- 0.5 credits per successful request. If no data is returned, no credits are deducted.

<div class="ic-ai-prompt-root" data-endpoint="connected-socials"></div>

## Request body

- ConnectedSocialsQuery
  - `platform` 'instagram' | 'youtube' | 'tiktok' | 'onlyfans' | 'twitter' | 'twitch', required
  - `handle` string, required — Creator identifier — username, profile URL, or YouTube channel ID (UC...).

## Response `200`

- ConnectedSocialsResponse
  - `result` ConnectedSocial[], required
    - `platform` string, required — The creator's social media platform.
    - `user_id` string, nullable — The creator's unique platform identifier.
    - `url` string, nullable — The creator's profile URL.
    - `username` string, nullable — The creator's username on the platform.
    - `fullname` string, nullable
    - `picture` string, nullable — URL to the creator's profile picture. This URL is temporary and expires after 24 hours. To keep the image, download it to your own storage before it expires.
    - `followers` integer, nullable
  - `credits_cost` number, double, required
  - `response_meta` object, required

## Other responses

- `400` — Bad request — invalid input or unsupported state.
- `401` — Unauthorized — missing or invalid API key.
- `403` — Forbidden — caller is not permitted to perform this action.
- `422` — Unprocessable entity — validation failed.
- `429` — Too Many Requests — rate or capacity limit exceeded. Inspect the `Retry-After` header and the `retry_after` body field for the wait time in seconds.

## Changes

- **2026-08-18** `87e654ac822e` — 3 info
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

[Change history](https://skmtc.dev/influencers/apis/core-api-concepts/changes/public/v1/creators/socials/post.md)

---

[API](https://skmtc.dev/influencers/apis/core-api-concepts.md) · [All operations](https://skmtc.dev/influencers/apis/core-api-concepts/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/influencers/core-api-concepts/revisions/87e654ac822e/schema)