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

# Listar acções recomendadas

Retorna a lista de acções recomendadas (planos de acção) para melhorar a visibilidade de uma marca específica. Pode filtrar os resultados pelo estado da acção (`status`), como por exemplo `queued` ou `completed`.

<RequestExample>
  ```bash Exemplo de cURL theme={null}
  curl --request GET \
    --url 'https://https://beta.semantika.app/api/v1/brands/1/actions?status=queued&per_page=10' \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json Resposta de Sucesso (200) theme={null}
  {
    "data": [
      {
        "id": 101,
        "title": "Optimizar página inicial",
        "description": "Melhorar as keywords e a relevância da página principal para os LLMs.",
        "status": "queued",
        "priority": 1,
        "impact": "high",
        "effort": "low",
        "estimated_visibility_impact_percentage": 5.0,
        "rationale": "A página inicial tem pouca visibilidade para o termo principal nos modelos AI actuais.",
        "steps": [
          {
            "step": 1,
            "instruction": "Adicionar menção à entidade na secção 'Sobre'."
          }
        ],
        "sources": [],
        "created_at": "2023-10-12T10:00:00Z",
        "updated_at": "2023-10-12T10:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [Listar marcas](/api-reference/listar-marcas.md)
- [API pública](/integrations/api.md)
- [Listar prompts monitorizados](/api-reference/listar-prompts-monitorizados.md)
- [Model Context Protocol (MCP)](/mcp-reference/overview.md)