API Specification v2.0.0

API Reference

Everything you need to integrate DoesItClick into your own marketing stack. Use our RESTful endpoints to automate simulations and extract persona intelligence.

Base URL

https://api.doesitclick.ai/v1

POST

/simulations

Initializes a new message test against selected personas. This is an asynchronous operation. You should poll the GET endpoint or use Webhooks to receive completion events.

Body Parameters

projectIduuidRequired

Target project for the simulation.

namestringRequired

Internal label for this run.

copySnapshotobjectRequired

The marketing content to test.

modestring

'fast' or 'robust' (N=5).

Request Example

{
  "projectId": "uuid",
  "name": "Landing Test A",
  "copySnapshot": {
    "headline": "Scale faster."
  },
  "personaIds": ["uuid"],
  "mode": "fast"
}

Response (201)

{
  "simulation": {
    "id": "sim_98213",
    "status": "pending",
    "createdAt": "2026-02-10T..."
  }
}

More coming soon

We are currently migrating our full OpenAPI spec to this interactive viewer.