> ## Documentation Index > Fetch the complete documentation index at: https://docs.postclean.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Listar contas sociais > Lista as contas sociais (canais) conectadas ao workspace. As contas são conectadas, reconectadas e removidas no app; a API não consegue alterá-las. `max_content_length` é o limite de texto de cada conta (uma conta do X com posts longos tem 25000). O tamanho da página é definido pelo servidor: leia `meta.per_page`. ## OpenAPI ````yaml /openapi.json get /social-accounts openapi: 3.1.0 info: title: PostClean API version: 2.0.0 description: >- API REST do PostClean. Autentique com uma chave de API do workspace, enviada como token Bearer no cabeçalho `Authorization`. servers: - url: https://post.chatclean.com.br/api description: PostClean security: - bearerAuth: [] tags: - name: Posts description: Criar, ler, atualizar, excluir e pré-visualizar posts. - name: Post notes description: Notas internas de um post, visíveis aos membros do workspace. - name: Approvals description: Aprovar ou rejeitar posts que aguardam aprovação. - name: Recurrence description: Fazer um post se repetir numa frequência. - name: Media and uploads description: Enviar arquivos e anexar mídia aos posts. - name: Social accounts description: Contas sociais conectadas e as opções de cada rede. - name: Channels description: Horários de postagem e fila de um canal. - name: Ideas description: Ideias do quadro Criar. - name: Idea stages description: As colunas (etapas) do quadro de ideias. - name: Analytics description: Métricas do workspace e dos canais. - name: Labels description: Etiquetas para organizar posts e ideias. - name: Signatures description: Textos reutilizáveis para adicionar aos posts. - name: Workspace description: O workspace ao qual a chave de API pertence. - name: API keys description: Chaves de API pessoais deste workspace. - name: Webhooks description: Webhooks de saída e os registros de entrega. - name: Repurposes description: Automações que republicam vídeos postados fora do PostClean. - name: Platform description: Recursos de cada plataforma e tipos de conteúdo. paths: /social-accounts: get: tags: - Social accounts summary: Listar contas sociais description: >- Lista as contas sociais (canais) conectadas ao workspace. As contas são conectadas, reconectadas e removidas no app; a API não consegue alterá-las. `max_content_length` é o limite de texto de cada conta (uma conta do X com posts longos tem 25000). O tamanho da página é definido pelo servidor: leia `meta.per_page`. operationId: listSocialAccounts parameters: - name: page in: query required: false schema: type: integer minimum: 1 default: 1 responses: '200': description: Uma página de contas sociais. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/SocialAccount' links: $ref: '#/components/schemas/PaginationLinks' meta: $ref: '#/components/schemas/PaginationMeta' example: data: - id: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54 platform: x display_name: PostClean username: postclean status: connected has_posting_schedule: true timezone: America/Sao_Paulo posting_goal: 5 max_content_length: 280 long_posts: false verified_badge: null - id: 9c8b7a69-4c5d-4e6f-8a0b-2c3d4e5f6071 platform: instagram display_name: PostClean username: postclean status: connected has_posting_schedule: false timezone: America/Sao_Paulo posting_goal: null max_content_length: 2200 long_posts: false verified_badge: null links: first: https://post.chatclean.com.br/api/social-accounts?page=1 last: https://post.chatclean.com.br/api/social-accounts?page=1 prev: null next: null meta: current_page: 1 from: 1 last_page: 1 links: - url: null label: '« Previous' page: null active: false - url: https://post.chatclean.com.br/api/social-accounts?page=1 label: '1' page: 1 active: true - url: null label: Next » page: null active: false path: https://post.chatclean.com.br/api/social-accounts per_page: 25 to: 2 total: 2 '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' components: schemas: SocialAccount: type: object properties: id: type: string format: uuid platform: $ref: '#/components/schemas/Platform' display_name: type: - string - 'null' description: Nome exibido da conta. username: type: - string - 'null' description: Nome de usuário na rede. status: type: string enum: - connected - disconnected - token_expired description: >- Status da conexão. `token_expired` e `disconnected` pedem reconexão no app. has_posting_schedule: type: boolean description: >- Se o canal tem horários de postagem. Colocar um post na fila (`queue`) exige horários. timezone: type: string description: >- Fuso horário IANA do canal. Os horários da fila e a recorrência seguem esse fuso. posting_goal: type: - integer - 'null' description: Meta de posts por semana do canal. max_content_length: type: integer description: >- Limite de texto desta conta, em caracteres. Uma conta do X com posts longos tem 25000. long_posts: type: boolean description: Se esta conta do X pode publicar posts longos. verified_badge: type: - string - 'null' enum: - blue - business - government - null description: >- Selo de verificação do X; `null` em outras redes ou em contas sem verificação. O selo sozinho não garante posts longos: veja `long_posts`. PaginationLinks: type: object properties: first: type: - string - 'null' last: type: - string - 'null' prev: type: - string - 'null' next: type: - string - 'null' description: Links para a primeira, a última, a anterior e a próxima página. PaginationMeta: type: object properties: current_page: type: integer description: Página atual. from: type: - integer - 'null' last_page: type: integer description: Última página. links: type: array items: type: object properties: url: type: - string - 'null' label: type: string page: type: - integer - 'null' active: type: boolean description: Links de navegação entre páginas. path: type: string per_page: type: integer description: >- Tamanho da página definido pelo servidor (hoje 25). Leia o valor em vez de supor. to: type: - integer - 'null' total: type: integer description: Total de itens em todas as páginas. description: Dados da página atual de uma lista paginada. Platform: type: string enum: - linkedin - linkedin-page - x - tiktok - youtube - facebook - instagram - instagram-facebook - threads - pinterest - bluesky - mastodon - telegram - discord - google_business description: >- Rede de uma conta social. `linkedin-page` é uma página de empresa no LinkedIn, e `instagram-facebook` é uma conta do Instagram conectada por uma Página do Facebook. ErrorBody: type: object properties: message: type: string description: Corpo de erro com uma mensagem. RateLimitErrorBody: type: object properties: name: type: string const: rate_limit_exceeded message: type: string examples: - Rate limit exceeded. Please retry after 30 seconds. description: Corpo devolvido quando o limite de requisições é excedido. responses: Unauthorized: description: >- Chave de API ausente, inválida, revogada ou expirada. Corpos possíveis: `Unauthenticated.` (sem chave, ou chave inválida ou revogada), `Token expired.` (passou do `expires_at`), `Token not found.` e `No workspace selected.` (a chave não está mais ligada a um workspace). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Unauthenticated. PaymentRequired: description: >- A conta do workspace não tem assinatura ativa nem período de teste. Corpo: `{"message": "Active subscription required."}`. content: application/json: schema: $ref: '#/components/schemas/ErrorBody' example: message: Active subscription required. Forbidden: description: >- A requisição não é permitida. Chaves de API só funcionam para administradores do workspace (o dono da conta ou um membro marcado como administrador); fora isso, toda requisição devolve `Insufficient workspace permissions.`. Outros corpos: `Workspace access denied.` (o usuário da chave saiu do workspace), `Personal access token required.` (foi enviado um token OAuth do MCP) e `This action is unauthorized.` (por exemplo, a nota pertence a outro membro). content: application/json: schema: $ref: '#/components/schemas/ErrorBody' TooManyRequests: description: 'Limite de requisições excedido: 60 por minuto por workspace.' headers: Retry-After: description: Segundos de espera antes de tentar de novo. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorBody' example: name: rate_limit_exceeded message: Rate limit exceeded. Please retry after 30 seconds. securitySchemes: bearerAuth: type: http scheme: bearer description: Chave de API do workspace, criada em Configurações > Chaves de API. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.