The ArticleGrade API.

Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx

x-api-key: ag_live_xxxxxxxxxxxxxxxxxxxx

{ "error": "a short, human-readable message" }

curl -X POST https://app.articlegrade.com/v1/audits \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/blog/best-running-shoes" }'

{
  "id": "aud_8Fq2kR1xR7",
  "status": "queued",
  "url": "https://example.com/blog/best-running-shoes"
}

curl https://app.articlegrade.com/v1/audits/aud_8Fq2kR1xR7 \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx"

{
  "id": "aud_8Fq2kR1xR7",
  "status": "done",
  "score": 82,
  "provider": "claude",
  "title": "The Best Running Shoes of 2026",
  "live_url": "https://example.com/blog/best-running-shoes",
  "record": {
    "dims": [
      { "name": "Experience", "val": 78 },
      { "name": "Expertise",  "val": 85 },
      { "name": "Factual depth", "val": 80 }
    ],
    "errors": [
      {
        "phrase": "experts agree these are the best",
        "sev": "high",
        "fix": "Attribute to a named source or cite testing data.",
        "source": "claude"
      }
    ],
    "scores": { "claude": 82, "gemini": 76 },
    "text": "Choosing a running shoe comes down to…",
    "headings": ["How we tested", "Top picks"]
  },
  "pass": true,
  "threshold": 70
}

curl -N https://app.articlegrade.com/v1/audits/aud_8Fq2kR1xR7/stream \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx"

event: status
data: {"status":"running"}

event: complete
data: {"status":"done","score":82}

curl "https://app.articlegrade.com/v1/audits?limit=50" \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx"

curl -X POST https://app.articlegrade.com/v1/audits/bulk \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "urls": ["https://example.com/a", "https://example.com/b"] }'

{
  "accepted": [
    { "id": "aud_aa11", "url": "https://example.com/a" }
  ],
  "rejected": [
    { "url": "not-a-url", "reason": "invalid url" }
  ]
}

curl https://app.articlegrade.com/v1/account \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx"

{
  "org": "Acme Media",
  "usage": { "included": 200, "used": 147, "overage": 0 },
  "features": { "api": true, "bulk": true, "schedules": true, "webhooks": true }
}

curl -X POST https://app.articlegrade.com/v1/schedules \
  -H "Authorization: Bearer ag_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pillar", "cadence": "weekly" }'

{
  "event": "audit.completed",
  "data": {
    "id": "aud_8Fq2kR1xR7",
    "url": "https://example.com/blog/best-running-shoes",
    "score": 82,
    "status": "done"
  },
  "ts": 1782000000
}

const crypto = require('crypto');

function verify(rawBody, header, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  const received = (header || '').replace('sha256=', '');
  // timingSafeEqual throws on length mismatch — guard first
  const a = Buffer.from(expected, 'hex');
  const b = Buffer.from(received, 'hex');
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

// Express — capture the RAW body for verification:
// app.post('/ag-webhook', express.raw({ type: 'application/json' }),
//   (req, res) => {
//     if (!verify(req.body, req.get('X-AG-Signature'), SECRET))
//       return res.sendStatus(401);
//     const evt = JSON.parse(req.body.toString());
//     res.sendStatus(200);
//   });

#!/usr/bin/env bash
set -euo pipefail

URL="$1"
THRESHOLD=70
AUTH="Authorization: Bearer $AG_API_KEY"
BASE="https://app.articlegrade.com"

# 1. start the audit, capture the id
ID=$(curl -sS -X POST "$BASE/v1/audits" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d "{\"url\":\"$URL\"}" | jq -r '.id')

# 2. poll until the audit is done
while :; do
  RES=$(curl -sS "$BASE/v1/audits/$ID" -H "$AUTH")
  STATUS=$(echo "$RES" | jq -r '.status')
  [ "$STATUS" = "done" ] && break
  [ "$STATUS" = "error" ] && { echo "audit failed"; exit 1; }
  sleep 3
done

# 3. gate on the score
SCORE=$(echo "$RES" | jq '.score')
echo "ArticleGrade score: $SCORE (threshold $THRESHOLD)"
if [ "$SCORE" -lt "$THRESHOLD" ]; then
  echo "::error::content quality below threshold — blocking publish"
  exit 1
fi