API Reference

API Documentation

Integrate Marketeze hook analysis into your applications

Getting Started

The Marketeze API allows you to analyze and generate viral hooks programmatically. All API access requires a Pro subscription.

Authentication

All API requests require authentication using a Bearer token.

Rate Limiting

API requests are limited to 20 requests per minute per API key.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer mk_live_your_key_here

Get your API key from Settings → API Access

Rate Limiting

API requests are limited to 20 requests per minute per API key.

Rate limit information is included in response headers:

X-RateLimit-Limit: Maximum requests per window

X-RateLimit-Remaining: Requests remaining in current window

X-RateLimit-Reset: Unix timestamp when the window resets

Endpoints

POST/api/v1/analyze

Analyze Hook

Analyze a hook and get a viral score with detailed breakdown.

Request Body

{
  "hook": "string (1-500 chars, required)",
  "platform": "tiktok|youtube|instagram|twitter|linkedin|other (optional)",
  "niche": "string (optional)"
}

Response

{
  "id": "uuid",
  "score": 1-100,
  "breakdown": {
    "curiosity": 1-100,
    "urgency": 1-100,
    "specificity": 1-100,
    "emotion": 1-100,
    "clarity": 1-100
  },
  "feedback": "string",
  "improvements": ["string", ...]
}

Error Codes

All errors follow a consistent format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

VALIDATION_ERRORInvalid request parameters

URL_SUBMISSIONURL submitted instead of hook text

MISSING_AUTHAuthorization header not provided

INVALID_KEYAPI key is invalid

KEY_REVOKEDAPI key has been revoked

SUBSCRIPTION_REQUIREDActive Pro subscription required

RATE_LIMITEDToo many requests, try again later

NOT_FOUNDResource not found

INTERNAL_ERRORServer error, please try again

Ready to get started?

Create your API key and start integrating in minutes.

Get Your API Key