---
title: "List placements"
method: GET
path: "/api/profiles/{id}/placements"
tags: ["Profiles"]
---

# List placements

`GET /api/profiles/{id}/placements`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{id}/placements`
- Auth: HTTP bearer

Retrieves the available placements for a profile (Facebook pages, LinkedIn personal profile and organizations, Pinterest boards, Telegram channels, Google Business locations). Available for facebook, linkedin, pinterest, telegram, and google_business profiles.

## Path parameters

- `id` string, required

## Query parameters

- `profile_group_id` string

## Response `200`

List of placements for the profile

- object
  - `data` ProfilePlacement[]
    - `id` string, nullable: Platform-specific placement ID. null for personal profile (LinkedIn).
    - `name` string: Display name of the placement.
    - `avatar_url` string, nullable: Stable Postproxy storage URL of the placement's picture, resized to 256x256 (Facebook Pages). null until it has been mirrored and for networks without one.
    - `metadata` object: Extra per-placement data Postproxy stores. For Google Business this carries the location's place_id (Google Maps Place ID). {} when there's nothing extra.

## Other responses

- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)