Dataczar
Browse helpers

API Reference / checks / canonical-tag-checker

Inspect canonical <link> tags and compare to an expected host.

Pulls the page HTML, extracts every canonical link, and flags mismatched hostnames so SEO reviewers can confirm canonicalization. Drop this helper wherever you want to inspect canonical <link> tags and compare to an expected host with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.

GETPOST/checks/canonical-tag-checker

Where this helper shines

Inspect canonical <link> tags and compare to an expected host. keeps checks helpers on autopilot. Use it whenever you need to inspect canonical <link> tags and compare to an expected host without pausing a sprint or asking design/dev to jump in.

  • Trigger this helper whenever you need to inspect canonical <link> tags and compare to an expected host without waiting on a full deploy.
  • Drop it into automations (Zapier, Make, workers) to inspect canonical <link> tags and compare to an expected host as part of your workflow.
  • Share the GET URL so support and success can inspect canonical <link> tags and compare to an expected host safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/checks/canonical-tag-checker?url=https%3A%2F%2Fexample.com%2Fsample.png&expected_hostname=sample-expected_hostname&timeout=8.0&dryrun=true&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/checks/canonical-tag-checker?url=https%3A%2F%2Fexample.com%2Fsample.png&expected_hostname=sample-expected_hostname&timeout=8.0&dryrun=true&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/checks/canonical-tag-checker?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "expected_hostname": "sample-expected_hostname",
  "timeout": "8.0",
  "dryrun": "true"
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

NameTypeDescription
urlstring · required
expected_hostnamestringOptional hostname to enforce.
timeoutnumber
dryrunboolean

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

Canonical details.

{
  "ok": true,
  "data": {
    "url": "https://example.com/blog",
    "canonical_url": "https://example.com/blog",
    "canonical_tags": [
      "https://example.com/blog"
    ],
    "expected_hostname": "example.com",
    "hostname_match": true
  }
}

Examples

Query parameters

Equivalent curl
Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Get your API keyBrowse helpers
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.