API Reference

Integrate GetIntent personalization directly into your applications.

Authentication

All API requests require authentication using your API key in the header:

X-API-Key: YOUR_API_KEY

Find your API key in the dashboard settings.

Base URL

https://api.getintent.co/api

Endpoints

POST/api/v1/personalize

Generate personalized content for a visitor based on UTM parameters

Parameters

Name	Type	Required	Description
siteId	string	required	Your site ID
utm_source	string	optional	Traffic source
utm_medium	string	optional	Marketing medium
utm_campaign	string	optional	Campaign name
utm_term	string	optional	Search term
utm_content	string	optional	Content variant

Response

{
  "transformations": [
    {
      "selector": "h1.hero-title",
      "original": "Welcome to our platform",
      "transformed": "The best CRM for startups"
    }
  ],
  "cached": false,
  "generatedAt": "2025-01-13T12:00:00Z"
}

GET/api/v1/sites/:siteId

Get site configuration and settings

Parameters

Name	Type	Required	Description
siteId	string	required	Your site ID (path parameter)

Response

{
  "id": "site_abc123",
  "domain": "example.com",
  "status": "active",
  "personalizationMode": "auto"
}

POST/api/v1/track/pageview

Track a page view with UTM attribution

Parameters

Name	Type	Required	Description
siteId	string	required	Your site ID
url	string	required	Page URL
referrer	string	optional	Referrer URL
utm_*	string	optional	UTM parameters

Response

{
  "success": true,
  "pageviewId": "pv_xyz789"
}

POST/api/v1/track/conversion

Track a conversion event

Parameters

Name	Type	Required	Description
siteId	string	required	Your site ID
type	string	required	Conversion type (signup, purchase, etc.)
value	number	optional	Conversion value
metadata	object	optional	Additional metadata

Response

{
  "success": true,
  "conversionId": "conv_abc123"
}

Rate Limits

API requests are rate limited based on your plan:

• Beta: 100 requests/minute
• Pro: 1,000 requests/minute
• Enterprise: Custom limits