API Reference

Build with the Hvrocket API

Integrate AI-powered creative analysis into your applications with our simple, powerful REST API.

Quick start

Get up and running with just a few lines of code. Here's how to analyze your first ad creative.

Request

curl -X POST https://api.hvrocket.com/v1/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/ad-creative.png",
    "brand_context": {
      "name": "Acme Corp",
      "industry": "Technology",
      "target_audience": "B2B professionals"
    }
  }'

Response

{
  "id": "ana_abc123",
  "status": "completed",
  "score": 87,
  "analysis": {
    "strengths": [
      "Clear value proposition",
      "Strong visual hierarchy",
      "Brand consistency"
    ],
    "improvements": [
      "Consider a more contrasting CTA color",
      "Add social proof elements"
    ],
    "predictions": {
      "estimated_ctr": "2.3%",
      "confidence": 0.89
    }
  }
}

API endpoints

Available endpoints for interacting with the Hvrocket API.

POST/api/v1/analyze

Analyze an ad creative and receive AI-powered feedback.

POST/api/v1/compare

Compare two or more ad creatives side by side.

POST/api/v1/generate

Generate new creative concepts based on brand context.

GET/api/v1/analyses/{id}

Retrieve the results of a previous analysis.

GET/api/v1/analyses

List all analyses for your account.

DELETE/api/v1/analyses/{id}

Delete a specific analysis.

Simple authentication

Secure your requests with API keys. Generate and manage keys from your dashboard.

Webhooks

Receive real-time notifications when analyses complete with configurable webhooks.

Rate limiting

Generous rate limits with clear error messages. Contact us for higher limits.

Ready to get started?

Get your API key