Create CTR (search-and-click) campaign
create_ctr_campaignBoost search CTR by sending human-like visitors who search your keywords, click your target URL, and browse like real users.
Instructions
Send visitors who search the given keywords on a search engine (Google by default), find the target URL in the results and click it, then browse like a human. SPENDS CREDITS immediately (same rate as traffic, per visitor). Confirm with the user before creating. Use list_search_engines for valid search_engine values.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Spread the visitors over this many days. | |
| link | Yes | Target page the visitors should land on. | |
| title | No | Campaign name shown in the dashboard. | |
| device | No | mixed | |
| country | No | Visitor geo. WW = worldwide mix. | WW |
| keywords | Yes | Search queries the visitors will type. | |
| referrer | No | Apparent traffic source, e.g. "facebook.com" or a full URL. Empty = direct. | |
| visitors | Yes | Total visitors to send (min 30, max 1,000 per scheduled day). | |
| delay_max | No | Max seconds on page. | |
| delay_min | No | Min seconds on page. | |
| pages_max | No | Max internal pages per visit. | |
| pages_min | No | Min internal pages per visit. | |
| ai_enabled | No | Human-like AI browsing (scrolling, reading, internal clicks). | |
| bounce_rate | No | Percent of single-page visits. | |
| click_links | No | Paths or CSS selectors the visitor may click, e.g. ["/pricing", "button.cta"]. | |
| search_only | No | Search without clicking the result (search-volume boost only). | |
| click_chance | No | Percent of visitors who click one of click_links. | |
| video_chance | No | ||
| search_engine | No | Engine key from list_search_engines (GOOGLE, BING, YAHOO, DUCKDUCKGO, YANDEX, BAIDU, NAVER, AMAZON, ...). | |
| search_language | No | Search UI language code. | en |
| search_pages_max | No | How many result pages to scan for the target URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | Yes | ||
| status | Yes | ||
| message | Yes | ||
| task_id | Yes | ||
| ctr_mode | No | ||
| visitors | Yes | ||
| campaign_id | Yes | ||
| dashboard_url | Yes |