---
title: "List Brand Social Channels"
method: GET
path: "/brands/social-channels"
tags: ["Project"]
---

# List Brand Social Channels

`GET /brands/social-channels`

## Request

- Base URL: `https://api.peec.ai/customer/v1`
- URL: `https://api.peec.ai/customer/v1/brands/social-channels`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
  - HTTP bearer

List the social channels configured for a project, optionally filtered to one brand.

## Query parameters

- `project_id` string: Required if using a company api key
- `brand_id` string

## Response `200`

Response for status 200

- object
  - `data` object[], required
    - `id` string, required
    - `brand_id` string, required
    - `platform` 'reddit' | 'youtube' | 'instagram' | 'tiktok' | 'linkedin' | 'medium', required
    - `channel_id` string, required
    - `channel_handle` string, required

## Changes

- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/brands/social-channels/get.md)

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) - [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peec/apis/peec-ai-customer-api/revisions/9d774600c8eb?raw)