REST API

Everything on the website is available as a JSON API at https://dropslop.ai/v1/. This page covers the parts most people need. The full list of endpoints and fields is in the API reference, and the Developers page has more examples.

AuthenticationCopy Anchor Link

Make a key on the API keys page (you need a free account). Keys start with hk_live_. DropSlop shows a key once, when you make it; store it somewhere safe.

Send the key in either header:

Authorization: Bearer hk_live_YOUR_KEY
# or
X-API-Key: hk_live_YOUR_KEY

Each key has its own limit of requests a minute, shown under its name on the keys page. Checked words, rewritten words and certificates come out of your plan's allowance; see Words, certificates and plans.

Check a text: X-RayCopy Anchor Link

POST /v1/xray returns the whole-draft scores, a score and tone for each paragraph, and the tells it found.

curl -X POST https://dropslop.ai/v1/xray \
  -H "Authorization: Bearer $DROPSLOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Paste the draft here."}'

The response includes scores (the whole draft), summary, blocks (one per paragraph, each with a tier of CLEAN, WARM or HOT) and tell_phrases.

Score only: detectCopy Anchor Link

POST /v1/detect returns just the scores, for one text or many.

The response includes combined (0 to 1), verdict, band and word_count. Scores are estimates; read How to read a score.

Rewrite: HumanizeCopy Anchor Link

A rewrite takes up to a few minutes, so it runs as a job: start it, then ask for the result.

JOB=$(curl -s https://dropslop.ai/v1/humanize/jobs \
  -H "Authorization: Bearer $DROPSLOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Paste the draft here.", "pinned_terms": ["Northwind"]}' | jq -r .job_id)

while [ "$(curl -s https://dropslop.ai/v1/humanize/jobs/$JOB | jq -r .status)" = "running" ]; do sleep 3; done
curl -s https://dropslop.ai/v1/humanize/jobs/$JOB

POST /v1/humanize/jobs:

It answers with job_id (it starts hj_), status: "running" and poll_url.

GET /v1/humanize/jobs/{job_id} returns status: running, then completed with the result, or failed with an error. A completed job includes text (the rewrite), before_scores, after_scores, summary (how many paragraphs were rewritten) and fact_guard, whose status is PASS, WARN (a fact was dropped) or FAIL (a fact was added). See Fact-Guard.

Site auditCopy Anchor Link

POST /v1/site-audit starts an audit and returns at once with a job_id.

curl -X POST https://dropslop.ai/v1/site-audit \
  -H "Authorization: Bearer $DROPSLOP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input_mode": "domain", "target": "https://example.com", "max_pages": 50}'

The response includes job_id, status, phase and progress_pct.

• GET /v1/site-audit/{job_id} returns progress while it runs, then the report: domain_summary, pages, top_10_worst_pages and top_ai_tells.
• GET /v1/site-audit/{job_id}/export.csv downloads the report as CSV.

Audit reports are public to anyone with the job's link; see Site audit.

CertificatesCopy Anchor Link

POST /v1/certify issues a certificate and uses one certificate for each 1,000 words or part of them (a 2,400-word text uses 3).

This sends the text to GPTZero and Pangram. The response includes the certificate's id and its page at /v/{id}.

Your usageCopy Anchor Link

GET /v1/usage?days=30 returns your checked words, rewritten words and certificates used against your allowance, day by day.

ErrorsCopy Anchor Link