Actions

Crawl a page

POST /api/v1/projects/{id}/pages/{pageId}/crawl

Requires edit-pages.

API key access: Read and write
Project permission: Edit pages
Success: 202 — Job queued (or an identical one is already queued)

Parameters

Path

Parameter	Type	Notes
`id` required	string	Project id
`pageId` required	string

Example request

Replace tk_live_YOUR_KEY with your API key and the ids with your own.

curl -X POST 'https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/pages/6651b5d3f2c4e6a8b0d2f401/crawl' \
  -H 'Authorization: Bearer tk_live_YOUR_KEY'

const response = await fetch('https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/pages/6651b5d3f2c4e6a8b0d2f401/crawl', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tk_live_YOUR_KEY',
  },
});

const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result.data);

import requests

response = requests.post(
    "https://trackerv2.marketingplanet.global/api/v1/projects/6650a4c2e1b3d5f7a9c1e301/pages/6651b5d3f2c4e6a8b0d2f401/crawl",
    headers={"Authorization": "Bearer tk_live_YOUR_KEY"},
)
result = response.json()
if not response.ok:
    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result["data"])

Example response

202 Accepted

{
  "data": {
    "jobId": "6654e8a6c5f7b9d1e3a5c701",
    "kind": "page-crawl",
    "status": "queued",
    "deduplicated": false,
    "statusUrl": "/api/v1/jobs/6654e8a6c5f7b9d1e3a5c701"
  }
}

Response fields

Field	Type	Notes
`data`	object
`data.jobId`	string
`data.kind`	string
`data.status`	"queued" \| "running"
`data.deduplicated`	boolean	True when an identical job was already queued or running
`data.statusUrl`	string

Errors

Besides the errors any request can return (bad or missing key, plan, scope, rate limit), this endpoint can return:

Status	error.code	Meaning
404	`not-found`	The resource does not exist or you cannot open it. Tracker does not reveal which.
403	`flag-editPages`	Your project membership does not include editing pages.
403	`forbidden`	The account is restricted: reads still work, but changes that add or modify projects, pages or monitors are blocked (`error.accountStatus` is `restricted`).

Errors always look like { "error": { "code": "…", "message": "…" } }. See Errors & limits.