CTR API

Fresh

Source: BIBLE.md (Phase 10 Route wrappers ctr-engine)

CTR endpoints: single click, batch, campaigns.

Routes

Method	Route	Body
POST	/ctr/run	{ keyword, targetDomain, city, state, dwellTime?, email?, ... }
POST	/ctr/batch	{ configs: [...] }
GET	/campaigns	-

Single CTR

curl -X POST http://localhost:4700/ctr/run \
  -H "Content-Type: application/json" \
  -H "x-api-key: ghost-engine-key" \
  -d '{
    "keyword": "junk removal dallas",
    "targetDomain": "journeyjunkremoval.com",
    "city": "Dallas",
    "state": "TX",
    "dwellTime": "medium"
  }'

Return shape

{
  "success": true,
  "keyword": "junk removal dallas",
  "targetDomain": "journeyjunkremoval.com",
  "location": "Dallas, TX",
  "found": true,
  "position": 7,
  "dwelledMs": 198420,
  "totalTimeMs": 312000,
  "warmupSearches": 2,
  "preClicks": 1,
  "internalClicks": 3
}

Parameters

Parameter	Values	Default
keyword	any string	required
targetDomain	domain	required
city	string	required
state	2-letter code	required
dwellTime	short/medium/long	medium
email	account email	random
warmupSearches	true/false	true
maxPages	1-10	3
testMode	true/false	false

Batch CTR

curl -X POST http://localhost:4700/ctr/batch \
  -H "Content-Type: application/json" \
  -H "x-api-key: ghost-engine-key" \
  -d '{
    "configs": [
      { "keyword": "junk removal dallas", "targetDomain": "client.com", "city": "Dallas", "state": "TX" },
      { "keyword": "junk hauling dallas", "targetDomain": "client.com", "city": "Dallas", "state": "TX" }
    ],
    "concurrency": 2
  }'

List campaigns

curl http://localhost:4700/campaigns

Related

• CTR Engine plugin
• Campaign Manager plugin
• CTR Campaign workflow