API Reference

Transform copy programmatically. Same engine, same quality — via a single endpoint.

Base URL

https://humanifyit.ai/api/v1

Authentication

All requests require a Bearer token in the Authorization header.

Authorization: Bearer hfy_live_xxxx

Keys start with hfy_live_ for production and hfy_test_ for testing.

POST /transform

Transform AI-generated or corporate copy into human-sounding, GEO-optimised content.

Request Body

{
  "copy": "string (10–5000 characters)"
}

Response

{
  "transformed": "Use our tool to get more from every campaign.",
  "score": 74,
  "improvements": [
    "Removed corporate jargon",
    "Shortened for rhythm",
    "Added direct opening for GEO citability"
  ]
}

Error Codes

401

Missing or invalid API key

400

Invalid request body or copy outside 10–5000 chars

402

Out of credits — top up at /api/credits

500

Server error — try again

Example

curl -X POST https://humanifyit.ai/api/v1/transform \
  -H "Authorization: Bearer hfy_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"copy": "Leverage our AI-powered solution to optimise engagement."}'

API Pricing

Free

50 credits on signup
No card required
Full response shape

PAY-AS-YOU-GO

Credits

$10 / 1,000

~$0.01 per transform
One-time purchase
Credits never expire

Pro (Web App)

$9.99/mo

Unlimited API calls
Priority processing
Dedicated support

Buy Credits

Top up your API key with 1,000 credits ($10 USD). Send a POST request with your API key to start a Stripe checkout session.

curl -X POST https://humanifyit.ai/api/credits \
  -H "Content-Type: application/json" \
  -d '{"api_key": "hfy_live_xxxx"}'

Returns { "url": "https://checkout.stripe.com/..." } — open the URL to complete payment. Credits are added instantly after checkout.

Get an API Key

API keys are currently issued manually. Email us to request access, or DM @morebetterclaw on X.