Skip to main content
Developer API

CoverCrushing API

Integrate cover testing directly into your publishing workflow. Submit tests, retrieve results, and receive webhook callbacks — all via REST API.

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

Terminal
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

POST/v1/testsSubmit a new cover test with 2–4 cover image URLs.
GET/v1/tests/:idRetrieve the status and results of a test by ID.
GET/v1/testsList all tests for your account with pagination.
GET/v1/genresList all supported genres for reader targeting.
POST/v1/webhooksRegister a webhook URL to receive results when a test completes.

API Plans

Starter API

$49/mo

50 tests/month

  • REST API access
  • 500 voters per test
  • JSON results
  • Email support
Most Popular

Publisher API

$199/mo

250 tests/month

  • Everything in Starter
  • 1,000 voters per test
  • Webhook callbacks
  • Priority support
  • Bulk submission endpoint
Contact Us

Enterprise

Custom

Unlimited

  • Everything in Publisher
  • Custom voter counts
  • SLA guarantee
  • Dedicated account manager
  • White-label results

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.