Apify HTTPS Status Checker 🚀

An Apify Actor that crawls websites and retrieves their HTTP status codes to help monitor site availability, detect broken links, and analyze redirects.

---

📌 Features

✅ Extracts URLs from sitemaps if available.
✅ Crawls websites when no sitemap is found to collect URLs.
✅ Retrieves HTTP status codes for each discovered URL.
✅ Detects broken links (404 errors) and highlights them.
✅ Provides structured JSON output with status summaries.
✅ Ideal for SEO audits, website monitoring, and performance analysis.

---

⚙️ Input Parameters

The actor accepts the following input in JSON format:

{
  "url": "https://example.com",
  "max_urls": 10,
  "follow_links": true,
  "mode": "auto"
}

Parameter	Type	Description
url	String	The target URL or domain (required)
max_urls	Integer	Maximum number of pages to analyze (default: 5)
follow_links	Boolean	Whether to follow links in the crawl (default: false)
mode	String	"sitemap", "crawl", or "auto" (default: "auto")

---

📤 Output Format

The actor returns structured JSON output with two key sections:

1️⃣ URL Details

Each scanned URL along with its status code.

{
  "details": [
    { "url": "https://example.com", "status": 200 },
    { "url": "https://example.com/missing-page", "status": 404 }
  ]
}

2️⃣ Status Code Summary

Aggregates occurrences of each HTTP status code.

{
  "overview": [
    { "Status Code": 200, "Count": 10 },
    { "Status Code": 404, "Count": 2 }
  ]
}

---

🚀 How to Run

Option 1: Using Apify Console

1. Go to the Apify Actor Page.
2. Click Run and provide the input JSON.
3. Retrieve results from the Dataset Storage.

Option 2: API Execution (cURL)

Run the actor directly via API:

cat > input.json <<'EOF'
{
  "url": "https://example.com",
  "max_urls": 10,
  "follow_links": true,
  "mode": "auto"
}
EOF

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=$API_TOKEN" \
  -X POST \
  -d @input.json \
  -H 'Content-Type: application/json'

---

🔍 Example Use Cases

💡 SEO Audits → Identify broken links and redirects.
💡 Website Monitoring → Track site uptime & status changes.
💡 Data Validation → Ensure external links are working.
💡 Content Management → Find outdated or broken content.

---

📚 Resources

• Apify Docs
• HTTP Status Codes Reference

---

🛠️ Author & Support

Created by Antonio Blago antonioblago.de🛠️
💬 Need help? Reach out via Apify Community

---