For Agents
Score text or uploaded documents for AI-generation likelihood with per-sentence breakdowns. Supports single-document, batch, and report retrieval flows.
Get started with GPTZero API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"detect whether a passage of text was ai-generated"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with GPTZero API API.
Score a passage of text for AI authorship via POST /predict/text
Analyse uploaded documents (PDF, DOCX, TXT) through POST /predict/files
Submit a batch of documents for asynchronous scoring via POST /batch
Poll batch status and retrieve per-document scores from GET /batch/{batchId}
GET STARTED
Use for: Check whether a student essay was AI-generated, Score a long-form article for AI authorship probability, Submit a batch of documents for asynchronous AI detection, Retrieve the results of an earlier GPTZero batch run
Not supported: Does not generate text, run plagiarism scans, or detect AI-generated images — use for AI-text detection scoring only.
Jentic publishes the only available OpenAPI document for GPTZero API, keeping it validated and agent-ready.
GPTZero is an AI-text detection service used widely in education and publishing to score whether a passage was written by a human or generated by a large language model. The v2 API exposes seven endpoints across single-text scoring, document file analysis, batch submission, and report retrieval, returning per-document and per-sentence probability scores plus optional perplexity and burstiness metrics. It is designed for teachers, editors, and platform integrity teams who need a programmatic signal on AI-generated content.
Pull historical detection reports with GET /reports and GET /reports/{reportId}
Patterns agents use GPTZero API API for, with concrete tasks.
★ School-Wide Submission Screening
Schools submitting student work into a GPTZero workflow use POST /batch to send a class-worth of essays in one request, then poll GET /batch/{batchId} until results are ready. The per-sentence scoring helps teachers see exactly which passages triggered the model. Detection is probabilistic — schools should treat the score as a triage signal and pair it with a conversation with the student.
POST /batch with 30 essay bodies, poll GET /batch/{batchId} every 10 seconds until status=complete, then surface essays with score above 0.7.
Editorial Content Authenticity Check
Publishers screen freelance submissions through POST /predict/text or /predict/files to flag pieces that may be AI-generated for additional review. The endpoint returns overall and per-sentence probabilities plus perplexity metrics, giving editors a defensible signal before contracting with a writer. The API does not authenticate authorship — it scores statistical likelihood only.
POST /predict/text with a 1500-word draft and route the submission to a senior editor when document_classification is 'AI-generated'.
Document File Analysis
POST /predict/files accepts PDF, DOCX, and TXT uploads, extracting the text server-side and returning the same scoring shape as /predict/text. This avoids the agent having to parse mixed file formats locally and keeps OCR and extraction logic on GPTZero's side. Maximum file size is bounded by the user's plan tier.
POST /predict/files with a multipart upload of a PDF and return the per-paragraph AI-generation probabilities.
Account-Level Report Auditing
Compliance and academic-integrity teams pull historical detections via GET /reports for retention or audit purposes. GET /reports/{reportId} returns the full prior verdict including the input text snapshot, score, and timestamp, supporting policies that require evidence to be preserved alongside the decision.
Call GET /reports?limit=50, filter to the past 7 days, and produce a summary of how many submissions exceeded the 0.7 threshold.
Agent Detection via Jentic
An agent moderating user-generated content uses Jentic to discover GPTZero, load /predict/text, and execute with the user's submission. The X-API-Key is held in Jentic's MAXsystem vault, so the agent never sees the raw secret. The agent reasons over the returned probability and decides whether to escalate.
Use the Jentic SDK to search 'detect ai-generated text', load POST /predict/text, and execute with the user-submitted body.
7 endpoints — gptzero is an ai-text detection service used widely in education and publishing to score whether a passage was written by a human or generated by a large language model.
METHOD
PATH
DESCRIPTION
/predict/text
Synchronously score a text passage for AI authorship
/predict/files
Score an uploaded PDF, DOCX, or TXT document
/batch
Submit a batch of documents for asynchronous scoring
/batch/{batchId}
Poll batch status
/batch/{batchId}/results
Retrieve per-document batch results
/reports
List historical detection reports
/reports/{reportId}
Retrieve a specific historical report
/predict/text
Synchronously score a text passage for AI authorship
/predict/files
Score an uploaded PDF, DOCX, or TXT document
/batch
Submit a batch of documents for asynchronous scoring
/batch/{batchId}
Poll batch status
/batch/{batchId}/results
Retrieve per-document batch results
Three things that make agents converge on Jentic-routed access.
Credential isolation
GPTZero's X-API-Key is stored encrypted in Jentic's MAXsystem vault. The header is injected at execution time, so the raw key never appears in agent prompts, tool outputs, or transcripts.
Intent-based discovery
Agents search Jentic with intents like 'detect ai-generated text' and Jentic returns POST /predict/text or /predict/files with their request schemas, so the agent picks the synchronous or document path without reading the spec.
Time to first call
Direct integration: half a day for key provisioning, request schema modelling, and batch polling logic. Through Jentic: under 30 minutes — the batch poll loop is wrapped in the SDK execution flow.
Alternatives and complements available in the Jentic catalogue.
Winston AI API
Competing AI-content detection plus image detection, plagiarism, and fact-checking
Pick Winston when the workflow needs AI-image detection, plagiarism, or fact-checking alongside text scoring; pick GPTZero for education-focused document and batch scoring.
OpenAI API
The model often producing the text being scored — pair generation with detection
Use OpenAI to generate or rewrite content and GPTZero to score the output before publishing.
Anthropic Messages API
Claude completions that pair with GPTZero scoring after generation
Pick Anthropic Messages for generation and route the output through GPTZero for AI-detection scoring.
Specific to using GPTZero API API through Jentic.
What authentication does the GPTZero API use?
GPTZero uses an API key sent in the X-API-Key header. Generate keys in the GPTZero dashboard and rotate them per environment. Through Jentic, the X-API-Key is stored in MAXsystem and injected at execution time so the agent never handles the raw secret.
Can I score a PDF directly with this API?
Yes. POST /predict/files accepts a multipart upload of PDF, DOCX, or TXT files and returns the same scoring shape as /predict/text. GPTZero handles text extraction server-side, so the agent does not need a local PDF parser.
What are the rate limits for the GPTZero API?
The OpenAPI spec does not declare rate limits. Limits are enforced at the gateway tied to your plan tier. Free and education tiers have stricter monthly word quotas; paid tiers raise the per-minute concurrency. Cache identical text bodies to avoid duplicate spend.
How do I submit a batch of documents through Jentic?
Search Jentic for 'submit a batch of documents for ai detection', load POST /batch, and execute with the document array. Then call GET /batch/{batchId} to poll status and GET /batch/{batchId}/results to retrieve per-document scores once status is complete.
What does the per-sentence breakdown contain?
Both /predict/text and /predict/files return a sentence-level array where each entry includes the sentence text and an AI-generation probability. This lets reviewers see exactly which passages triggered the model rather than relying only on a document-level score.
Is the GPTZero API free?
GPTZero offers a free tier with limited monthly words and a paid tier with higher quotas, batch access, and priority concurrency. Education customers can apply for institution-wide pricing. Pricing is published on gptzero.me.
/reports
List historical detection reports
/reports/{reportId}
Retrieve a specific historical report