Registro de alterações

Mantenha-se atualizado com novos recursos e alterações da API

11.03.2026

Lançamento do servidor MCP

Novo

Conecte assistentes de IA ao SurveyNinja via Model Context Protocol.

Novidades:

  • Endpoint de produção https://mcp.surveyninja.io/mcp/v1 sobre o protocolo JSON-RPC 2.0.
  • 16 recursos somente leitura — pesquisas, respostas, análises, temas, códigos promocionais.
  • Mais de 30 ferramentas — criar, publicar, exportar, códigos promocionais, variáveis e muito mais.
  • Suporte pronto para Claude Desktop, Cursor e VS Code — configurações na documentação.
  • Limite de taxa: 180 requisições por minuto; os links de exportação são válidos por 1 hora.

Documentação: dev/api/mcp · Markdown completo para LLMs: /static/mcp_user_guide.md

25.02.2026

Lançamento do SurveyNinja API v3

Nova versão principal da API para trabalhar com pesquisas, respostas e relatórios.

Principais mudanças:

  • Ciclo de vida completo da pesquisa: criar, editar, publicar, arquivar.
  • Autenticação e gerenciamento de tokens atualizados para integrações.
  • URL base única https://api.surveyninja.io/api/v3/service substituindo os caminhos legados.
  • Filtros, ordenação e paginação ampliados para listas de pesquisas e respostas.
  • Estruturas de dados atualizadas (pesquisas, respostas, relatórios) alinhadas com api_v3.md.

Referência completa de endpoints em /dev/api e versão markdown em /static/api/llms-full.md.

18.09.2025

Novos parâmetros para recuperar respostas (API v3)

Melhorias no endpoint GET /quiz/{id}/answers

Parâmetros adicionados:

Novo parâmetro is_complete

Tipo: boolean|nullable

Padrão: nullable

Descrição: Filtra as respostas por status de conclusão. Se true — apenas respostas completas; se false — apenas incompletas.

Novo parâmetro sort

Tipo: string|nullable

Padrão: nullable

Valores disponíveis: date_start, date_end

Descrição: Campo pelo qual ordenar as respostas. date_start — por data de início; date_end — por data de conclusão.

Novo parâmetro order

Tipo: string|nullable

Padrão: nullable

Valores disponíveis: desc, asc

Descrição: Direção de ordenação. desc — decrescente; asc — crescente.

Exemplo de uso:
Exemplo de requisição
curl -X GET "https://api.surveyninja.io/api/v3/service/quiz/123/answers?is_complete=true&sort=date_start&order=desc" \ -H "Authorization: Bearer YOUR_TOKEN"

Baixe a versão em markdown da seção "Changelog" para uso no ChatGPT / outros LLMs: