CrawlForge
PemantauanLanjutan3 credits

track_changes

Jejaki perubahan kandungan pada halaman web dengan tangkapan garis dasar, perbandingan pintar dan pemantauan berjadual dengan amaran webhook. Sesuai untuk memantau pesaing, dasar undang-undang dan berita tergempar.

Kes Penggunaan

Pantau Halaman Harga Pesaing

Dapatkan amaran segera apabila pesaing mengubah harga, ciri atau tawaran produk

Jejaki Perubahan Dokumen Undang-undang/Dasar

Pantau Terma Perkhidmatan, Dasar Privasi atau dokumen pematuhan kawal selia

Pantau Tapak Berita untuk Kemas Kini

Kesan berita tergempar atau kemas kini artikel pada halaman tertentu dalam masa nyata

Kesan Gangguan atau Pencerobohan Laman Web

Dapatkan amaran apabila perubahan struktur yang ketara menunjukkan ralat atau serangan

Pantau Dokumentasi API untuk Perubahan Memecahkan

Jejaki halaman rujukan API untuk menangkap pengusangan dan perubahan memecahkan lebih awal

Endpoint

POST/api/v1/tools/track_changes
Auth Required
2 req/s pada pelan Free
3 credits

Parameters

NameTypeRequiredDefaultDescription
url
stringRequired-
URL untuk dipantau bagi perubahan
Example: https://competitor.com/pricing
operation
stringOptionalcompare
Jenis operasi: "create_baseline" | "compare" | "monitor" | "get_history" | "get_stats"
Example: compare
trackingOptions
objectOptional-
Pilihan tentang apa yang hendak dijejaki dan bagaimana
Example: {"granularity": "high", "ignoreWhitespace": true}
monitoringOptions
objectOptional-
Pilihan untuk pemantauan berjadual
Example: {"enabled": true, "interval": "1h"}
storageOptions
objectOptional-
Pilihan untuk penyimpanan sejarah perubahan
Example: {"retainHistory": true, "maxHistoryEntries": 100}

Panduan Operasi

Operasi berbeza untuk pelbagai aliran kerja pemantauan

create_baseline
Tangkap keadaan awal halaman web. Mesti dijalankan dahulu sebelum perbandingan. Mencipta syot kilat dengan cincang kandungan, panjang teks, kiraan pautan dan struktur.
compare
Bandingkan keadaan semasa halaman web dengan garis dasar. Mengembalikan skor perubahan, kepentingan dan senarai terperinci semua perubahan yang dikesan (teks, pautan, struktur).
monitor
Dayakan/lumpuhkan pemantauan berjadual dengan pemberitahuan webhook. Secara automatik menyemak perubahan pada selang yang ditentukan dan menghantar amaran apabila ambang dicapai.
get_history
Ambil sejarah perubahan untuk satu URL. Mengembalikan tatasusunan semua perubahan yang dikesan dengan cap masa, skor perubahan dan ringkasan.
get_stats
Dapatkan statistik pemantauan termasuk jumlah semakan, skor perubahan purata, masa semakan terakhir dan trend kekerapan perubahan.

Format Pemberitahuan Webhook

Apabila perubahan dikesan melebihi ambang, muatan ini dihantar ke webhook anda

webhook-payload.jsonJson
Endpoint webhook anda mesti mengembalikan 200 OK dalam masa 10 saat. Webhook yang gagal dicuba semula sehingga 3 kali dengan backoff eksponen.

Contoh Permintaan

terminalBash

Contoh Respons

200 OK2,340ms
{
  "success": true,
  "data": {
    "comparison": {
      "changeScore": 0.35,
      "significance": "medium",
      "changes": [
        {
          "type": "text",
          "description": "Pricing changed from $99/mo to $79/mo",
          "location": "div.pricing-card > span.price",
          "oldValue": "$99",
          "newValue": "$79",
          "impact": "high"
        },
        {
          "type": "link",
          "description": "New \"Enterprise\" link added",
          "location": "nav.pricing-tiers",
          "action": "added",
          "url": "/pricing/enterprise",
          "impact": "medium"
        },
        {
          "type": "structure",
          "description": "New section added: \"Compare Plans\"",
          "location": "main > section:nth-child(3)",
          "action": "added",
          "impact": "low"
        }
      ],
      "summary": "3 changes detected: 1 high impact, 1 medium impact, 1 low impact",
      "timestamp": "2025-10-15T14:30:00Z"
    },
    "baseline": {
      "url": "https://competitor.com/pricing",
      "captured_at": "2025-10-15T12:00:00Z",
      "hash": "a1b2c3d4e5f6",
      "metrics": {
        "textLength": 4567,
        "linkCount": 23,
        "elementCount": 145
      }
    },
    "history": {
      "totalChecks": 48,
      "changesDetected": 5,
      "lastCheck": "2025-10-15T14:30:00Z",
      "nextCheck": "2025-10-15T15:30:00Z"
    }
  },
  "credits_used": 3,
  "credits_remaining": 997,
  "processing_time": 2340
}
Field Descriptions
data.comparison.changeScoreSkor perubahan keseluruhan (0-1, di mana 1 adalah sepenuhnya berbeza)
data.comparison.significancelow, medium, atau high berdasarkan changeScore
data.comparison.changesTatasusunan perubahan yang dikesan dengan butiran
data.baseline.hashCincang unik kandungan garis dasar untuk perbandingan
data.history.nextCheckSemakan berjadual seterusnya (jika pemantauan didayakan)
credits_used3 credits tetap setiap operasi (baseline, compare, monitor, dll.)
processing_timeBiasanya 2-4 saat untuk operasi perbandingan

Pengendalian Ralat

Tiada Garis Dasar Ditemui (400 Bad Request)

Mesti menjalankan operasi create_baseline dahulu sebelum perbandingan. Setiap URL memerlukan garis dasar tersendiri.

Selang Pemantauan Tidak Sah (400 Bad Request)

Selang mestilah salah satu daripada: 15m, 30m, 1h, 6h, 24h. Selang yang lebih pendek memerlukan pelan yang lebih tinggi.

URL Tidak Boleh Diakses (400 Bad Request)

URL sasaran mengembalikan ralat atau disekat. Semak kebolehcapaian URL dan pengesahan.

Webhook Gagal (500 Internal Server Error)

URL webhook mengembalikan ralat atau tamat masa. Pastikan endpoint boleh diakses dan mengembalikan 200 OK.

Petua Pro: Gunakan granulariti high untuk halaman kritikal seperti harga atau dokumen undang-undang. Gunakan granulariti medium/low untuk halaman dengan kemas kini kecil yang kerap bagi mengurangkan positif palsu.

Kos Credit

3 credits
3 credits setiap operasi
Setiap operasi (create_baseline, compare, monitor, get_history, get_stats) berkos 3 credits. Semakan pemantauan berjadual dicaj setiap pelaksanaan.

Pecahan Kos:

create_baseline: 3 credits (sekali sahaja setiap URL)

compare: 3 credits setiap semakan

monitor (persediaan): 3 credits (sekali sahaja)

Semakan berjadual: 3 credits setiap pelaksanaan

get_history: 3 credits setiap pengambilan

get_stats: 3 credits setiap pengambilan

Contoh Kos Pemantauan:

Selang pemantauan 1 jam: 24 semakan/hari × 3 credits = 72 credits/hari/URL

Selang pemantauan 6 jam: 4 semakan/hari × 3 credits = 12 credits/hari/URL

Selang pemantauan 24 jam: 1 semakan/hari × 3 credits = 3 credits/hari/URL

Cadangan Pelan:

Pelan Free: 1,000 credits percubaan sekali sahaja = Pantau 5 URL pada selang 6h selama 1 bulan

Pelan Hobby: 5,000 credits = Pantau 25 URL pada selang 6h ($19/mo)

Pelan Professional: 50,000 credits = Pantau 250 URL pada selang 6h ($99/mo)

Alat Berkaitan

fetch_url
Pengambilan URL asas untuk perbandingan (1 credit)
extract_content
Ekstrak kandungan utama untuk pemantauan terfokus (2 credits)
stealth_mode
Pantau halaman terlindung tanpa pengesanan (5 credits)
batch_scrape
Pantau berbilang URL secara selari (1 credit setiap URL)
Bersedia untuk mencuba track_changes? Daftar percuma dan dapatkan 1,000 credits untuk mula memantau halaman pertama anda.