> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# social:read

> List connected social accounts, posts, and reviews across all platforms

<code>social:read</code>

The `social:read` scope provides read-only access to your site's Zernio-backed
social data: connected accounts, posts (and their per-platform targets), and
reviews. Reviews are available for Google Business Profile and Facebook only.

## Endpoints

| Method | Path                          | Description                          |
| ------ | ----------------------------- | ------------------------------------ |
| `GET`  | `/public/social/accounts`     | List connected social accounts       |
| `GET`  | `/public/social/posts`        | List social post targets             |
| `GET`  | `/public/social/posts/{id}`   | Get a post with its platform targets |
| `GET`  | `/public/social/reviews`      | List reviews                         |
| `GET`  | `/public/social/reviews/{id}` | Get a review                         |

## Error response — Missing scope

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "forbidden",
    "message": "This API key requires one of the following scopes: social:read",
    "details": {
      "required_scopes": ["social:read"]
    }
  }
}
```
