API Documentation

Integrate greenwashing scanning into your CI/CD pipeline or compliance workflow.

Authentication

Include your site key in the Authorization header:

Authorization: Bearer YOUR_SITE_KEY

Base URL

https://greenclaims-scanner.com/api/v1/

Endpoints

POST /api/v1/scan

Scan a URL for greenwashing claims.

Request

{
  "url": "https://example.com/sustainability",
  "nlp": true
}

Response

{
  "hash": "a1b2c3d4e5f6...",
  "url": "https://example.com/sustainability",
  "score": 72,
  "grade": "C",
  "grade_label": "Medium risk — Several claims need substantiation",
  "claims_found": 4,
  "claims": [
    {
      "term": "eco-friendly",
      "risk": "critical",
      "matched": "Our eco-friendly packaging...",
      "context": "...reduces waste with our eco-friendly packaging solutions that...",
      "recommendation": "Remove or replace with specific, verifiable claim.",
      "article": "Art. 3(1)(b) ECGT"
    }
  ],
  "scanned_at": "2026-02-21T10:30:00+00:00"
}

Rate Limits

Plan	Scans/day	Pages/scan	NLP
Business	200	500	Yes
Enterprise	Unlimited	Unlimited	Yes

Error Codes

Code	Meaning
400	Invalid request (missing URL, bad format)
401	Invalid or missing API key
422	Could not fetch or parse the target URL
429	Rate limit exceeded
500	Server error

Webhook (Coming Soon)

Configure webhooks to receive scan results when monitoring detects changes. Available on Business and Enterprise plans.