Skip to main content

Quick Start

This guide will show you how to get started through code samples. It will cover:

  • How to use the Respectify client class in your language to interact with Respectify

  • Initialise Respectify with a topic: this gives Respectify an understanding of what people are commenting on, and is usually a blog post, article, etc

  • Evaluate a comment, and get Respectify's feedback on how well it contributes to the conversation and in what ways the reply can be improved in order to encourage healthy interaction.

Installation and Authentication​

Install the library (pip install respectify or composer require respectify/respectify-php) and get an API key. See Installation for full details.

Check User Credentials​

Verifies your credentials work correctly. See Installation for more details.

from respectify import RespectifyClient

client = RespectifyClient(email, api_key)

result = client.check_user_credentials()
print(f"Active: {result.active}")
print(f"Plan: {result.plan_name}")
print(f"Endpoints: {result.allowed_endpoints}")

Initialising a Topic​

Respectify assesses a comment in the context of what it is replying to or is likely about. There is an implicit assumption that all comments are about something, and that is usually an article, blog post, or similar. It doesn't have to be online: you can just give Respectify some text.

But, you always need to initialise a topic so that when evaluating a comment, Respectify knows the 'something' that the conversation is about. See Topic Initialization for full details.

import os
from respectify import RespectifyClient

client = RespectifyClient(
    os.environ['RESPECTIFY_EMAIL'],
    os.environ['RESPECTIFY_API_KEY']
)

result = client.init_topic_from_url('https://en.wikipedia.org/wiki/Delphi')
article_id = result.article_id

# Or from text:
result = client.init_topic_from_text("Your article content here...")
article_id = result.article_id

Comment Scoring​

Evaluate a comment's quality and contribution to the conversation. See Comment Scoring for full details.

result = client.evaluate_comment(
    'This is a sample comment.',
    article_id
)

print(f"Overall Score: {result.overall_score}/5")
print(f"Toxicity: {result.toxicity_score}")
print(f"Low Effort: {result.appears_low_effort}")

for fallacy in result.logical_fallacies:
    print(f"Fallacy: {fallacy.fallacy_name}")

for phrase in result.objectionable_phrases:
    print(f"Objectionable: {phrase.quoted_objectionable_phrase}")

Check Relevance​

Evaluate whether a comment is on-topic and check for banned topics. See Relevance Checking for full details.

result = client.check_relevance(
    'This is a relevant comment',
    article_id,
    banned_topics=['politics', 'religion']
)

print(f"On Topic: {result.on_topic.on_topic}")
print(f"Banned Topics Found: {result.banned_topics.banned_topics}")

Check Dogwhistles​

Detect coded language that appears innocuous but carries hidden meanings. See Dogwhistle Detection for full details.

result = client.check_dogwhistle(
    'This is a comment to analyze.',
    article_id,
    sensitive_topics=['politics', 'social issues']
)

print(f"Dogwhistles Detected: {result.detection.dogwhistles_detected}")
print(f"Confidence: {result.detection.confidence}")

Check Spam​

Detect spam, promotional content, and bot-generated text. See Spam Detection for full details.

result = client.check_spam(
    'Buy cheap watches at example.com!',
    article_id
)

print(f"Is Spam: {result.is_spam}")
print(f"Confidence: {result.confidence}")

Megacall​

Run multiple analyses in a single API call for efficiency. See Megacall for full details.

result = client.megacall(
    'Comment to analyze.',
    article_id,
    include_spam=True,
    include_relevance=True,
    include_comment_score=True,
    include_dogwhistle=True
)

if result.spam_check:
    print(f"Spam: {result.spam_check.is_spam}")
if result.comment_score:
    print(f"Score: {result.comment_score.overall_score}/5")

That's it!​

You're good to go! Use Respectify's analysis to see if the comment meets the level of genuine interaction that you want to see in your online site.

We recommend using Respectify's feedback to give commenters an opportunity to improve what they write. And we hope that as your users see Respectify feedback they will learn from it how and why some ways of talking are better than others.

Respectify's ethos is not to censor, but to encourage and teach how to write and interact better. In fact, we hope that encouraging healthy conversation allows interaction with a more diverse range of opinions, through assisting people to interact and understand them. So, we encourage showing Respectify's analysis to your users and providing them a chance to iterate on what they write before it's posted.