Documentation

Getting Started

Bulk URL Checker is a cloud-based service that helps you check large lists of URLs for their status, redirects, and other important metrics. Here's how to get started:

• Sign up for a free account
• Choose your plan based on how many URLs you need to check monthly
• Upload your first CSV file with URLs
• Wait for notification when checking is complete
• Review results in the dashboard or export as CSV/JSON

Uploading CSV Files

Your CSV file should contain URLs to check. The format is simple:

url
https://example.com
https://example.com/page1
https://example.com/page2

Requirements:

• First column must be named url
• Each URL must include protocol (http:// or https://)
• Maximum file size: 50 MB
• Maximum URLs per file: 50,000
• Supported formats: CSV, TXT

Reading Reports

Once your URL check completes, the report includes:

• Status Code: HTTP response code (200, 404, 301, etc.)
• Final URL: The destination URL after redirects
• Redirect Chain: Full chain of redirects if any
• Response Time: How long the request took
• Indexing Data: Whether the URL is indexed by search engines

Understanding Status Codes:

• 200 - OK (page is working)
• 301/302 - Redirect (page moved)
• 404 - Not found (broken link)
• 403 - Forbidden (access denied)
• 500 - Server error

Using the Dashboard

The dashboard provides powerful filtering and search capabilities:

• Filter by Status: Show only 404s, redirects, or working links
• Search URLs: Quickly find specific URLs in large reports
• Sort Results: Order by status, response time, or URL
• Export Data: Download filtered results as CSV or JSON
• View History: Access past reports based on your retention period

API Access

Professional and Enterprise plans include API access for automation:

// Submit URLs for checking
POST /api/v1/checks
{
  "urls": ["https://example.com", "https://example.com/page"],
  "notify_email": "your@example.com"
}

// Get check results
GET /api/v1/checks/:checkId

// List all checks
GET /api/v1/checks

Authentication: Use your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Full API documentation will be available in your dashboard after signing up.

Frequently Asked Questions

How long does checking take?

It depends on the number of URLs and their response times. Generally, expect 10,000 URLs to take 1-2 hours. You'll receive a notification when done.

Can I check the same URLs multiple times?

Yes! Each check counts toward your monthly limit. Scheduled checks automatically recheck your URLs at your chosen interval.

What happens if I exceed my plan limit?

If you reach your monthly quota, you cannot exceed it - you must upgrade to a higher plan to continue checking URLs. Upgrades take effect immediately, giving you access to additional quota right away. Your quota resets on your billing cycle date.

Do you store my URLs?

Yes, but only for a limited retention period. After that, data is automatically deleted. You can also manually delete reports anytime.

Do credits expire?

No, credits never expire. Once you purchase a credit package, those credits stay in your account until you use them. There are no recurring charges or subscriptions.