Conteúdo e auditoria
Os artigos do blog da marca, sugestões de novos temas e o resultado das auditorias de página.
list_brand_blog_posts
Os artigos do blog da marca na Promptado, com título, slug, status, categoria, autor, tags e data de publicação.
Pergunte assim: "já tenho artigo sobre X?", "quais rascunhos estão parados?"
- brand_idstringobrigatório
- UUID da marca.
- statusenum
suggested,inactive,publishedouall(padrão).- searchstring
- Parte do título ou do slug.
- categorystring
- Parte do nome da categoria.
- limitinteger
- Padrão 200, máximo 1000.
get_blog_post
Um artigo completo: metadados, o ângulo do texto, descrição, palavras-chave, tempo de leitura e o conteúdo em Markdown.
- brand_idstringobrigatório
- UUID da marca.
- post_idstringobrigatório
- UUID do artigo, vindo de
list_brand_blog_posts.
suggest_articles
Reúne o contexto pra IA sugerir artigos novos sem repetir o que já existe: páginas do site (sitemap somado ao Search Console, com cliques e posição quando houver), artigos já criados, as páginas que dominam o nicho e as pesquisas que as IAs fazem.
Pergunte assim: "sugira artigos pra melhorar minha presença no ChatGPT"
- brand_idstringobrigatório
- UUID da marca.
- brand_prompt_idstring
- Foca num prompt.
- segment_idstring
- Foca num segmento.
- llm_providerstring
- Foca numa IA.
- searchstring
- Só prompts que contêm esse texto.
- exclude_termsstring[]
- Tira prompts que contêm esses termos.
check_audit_status
As auditorias recentes da marca e o status de cada uma: pending (aguardando), processing (rodando), completed (pronta) ou failed (deu erro).
- brand_idstringobrigatório
- UUID da marca.
- urlstring
- Só auditorias dessa página (parte da URL).
- statusenum
pending,processing,completed,failedouall(padrão).- limitinteger
- Padrão 10, máximo 30.
get_page_audit_result
O resultado mais recente da auditoria de uma página: as notas (geral, técnica, conteúdo e AEO), os problemas por gravidade e os detalhes de cada dimensão. Traz também is_indexed: se a página está fora do índice do Google, isso vem antes de qualquer ajuste de conteúdo, porque as IAs buscam na web.
Pergunte assim: "qual o resultado da auditoria da minha home?"
- brand_idstringobrigatório
- UUID da marca.
- page_urlstring
- A página auditada (parte da URL).
- audit_page_idstring
- Alternativa a
page_url. Um dos dois é obrigatório.