Simple REST API
Submit a test with a single POST request. Results arrive via webhook or polling.
Secure & reliable
Bearer token auth, HTTPS only, 99.9% uptime SLA on Publisher and Enterprise plans.
Structured JSON
All results returned as clean JSON — vote counts, Crush Scores, demographic breakdowns.
Submit a test in one request
curl -X POST https://api.covercrushing.com/v1/tests \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"genre": "romance",
"covers": [
{ "label": "Cover A", "url": "https://your-cdn.com/cover-a.jpg" },
{ "label": "Cover B", "url": "https://your-cdn.com/cover-b.jpg" }
],
"voter_count": 500,
"webhook_url": "https://your-app.com/webhooks/covercrush"
}'Available Endpoints
/v1/testsSubmit a new cover test with 2–4 cover image URLs./v1/tests/:idRetrieve the status and results of a test by ID./v1/testsList all tests for your account with pagination./v1/genresList all supported genres for reader targeting./v1/webhooksRegister a webhook URL to receive results when a test completes.API Plans
Built for publishers, tools, and platforms
Publishing houses
Submit all cover variants for a title in one API call. Receive structured results for editorial review.
Cover design tools
Integrate CoverCrushing into your design workflow. Let designers test directly from their tool.
Author service platforms
Offer cover testing as a value-add to your author community without building the infrastructure.
Marketing automation
Trigger a cover test automatically when a new title enters production. Receive results via webhook.