Perspective API documentation

Perspective is a free API that helps you host better conversations online. The API uses machine learning models to score the perceived impact a comment might have on a conversation. You can use this score to give feedback to commenters, help moderators more easily review comments, allow readers to more easily find interesting or productive comments, and more.

Perspective was created by Jigsaw and the Google Counter Abuse Technology team in a collaborative research initiative called Conversation-AI. Check out PerspectiveAPI.com to learn more about the API. For developer documentation and instructions on how to get started, please visit our Developers site at Support.PerspectiveAPI.com. If you can’t find the answer you’re looking for, contact us. Check out our other repositories for open source experiments, tools, and research data that explore ways to combat online toxicity and harassment. NOTE: While there are example calls to the API and demos in this repository, the code for the API is not open source.

Using Perspective API

1. Get started with Perspective API
   • About
   • Sample requests
   • Support
2. API Reference
   • Key concepts
   • Clients
   • Attributes
     • Model cards
   • Methods
   • Limits and errors
3. Concepts
   • Score normalization guide
4. Case studies
   • The New York Times
5. Contribution guidelines
   • How to label data
   • Privacy
6. Contact us

Download the example data CSV.

Releases and updates

Wednesday, August 23, 2017

Perspective API score normalization: fixes for Toxicity

Tuesday, June 13, 2017

Perspective API score normalization change

Improve the API

Help improve the Perspective API by leveraging the DoNotStore flag to ensure that all submitted comments are automatically deleted after scores are returned and/or the SuggestCommentScore method to submit corrections.

About this project

Perspective was created by Jigsaw and Google’s Counter Abuse Technology team in a collaborative research project called Conversation-AI. We open source experiments, attributes, and research data to explore the strengths and weaknesses of ML as a tool for online discussion.

Contact us if you have questions.

Privacy and Terms of Service

The Perspective API is provided under the Google Privacy Policy, and the Google APIs Terms of Service.