---
title: "List social sets"
method: GET
path: "/v2/social-sets"
tags: ["Social Sets"]
---

# List social sets

`GET /v2/social-sets`

Retrieve all social sets (accounts) you can access. This includes accounts you own directly and accounts that belong to teams you are a member of.

## Query parameters

- `limit` integer, nullable — Maximum number of items to return per page
- `offset` integer — Number of items to skip from the beginning

## Response `200`

OK

- PagedSocialSetListResponse
  - `results` SocialSetListResponse[], required
    - `id` integer, required — Unique identifier for the social set
    - `username` string, required — Username/handle for the social media account
    - `name` string, required — Display name of the social media account
    - `profile_image_url` string, nullable, required — URL to the profile image of the social media account. Null if not available.
    - `team` Team — Details of the team that owns this social set
      - `id` string, required — Unique identifier for the team
      - `name` string, required — Name of the team
  - `count` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next` string, nullable, required
  - `previous` string, nullable, required

## Other responses

- `401` — Missing or invalid authentication
- `429` — Rate limited

## Changes

- **2026-07-28** `784a28669fa5` — 1 breaking
  - response property `results/items/profile_image_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`

[Change history](https://skmtc.dev/raycast/apis/typefully-public-api/changes/v2/social-sets/get.md)

---

[API](https://skmtc.dev/raycast/apis/typefully-public-api.md) · [All operations](https://skmtc.dev/raycast/apis/typefully-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/raycast/typefully-public-api/revisions/784a28669fa5/schema)