TL;DR
A web crawling API is a service you call with a starting URL that discovers and traverses a site's pages for you, returning their content through one endpoint. It handles the frontier, politeness, deduplication, and blocking internally, so you get crawled pages without building or hosting a crawler yourself.
What It Replaces
Running your own crawler means owning a lot of moving parts: a URL frontier, scope and depth controls, polite pacing, deduplication, proxy rotation, and retry logic, plus the servers to run it on. A crawling API moves all of that behind one call:
import requests
response = requests.post(
"https://api.example.com/crawl",
json={"url": "https://example.com/blog", "depth": 2, "same_host": True},
headers={"Authorization": f"Bearer {API_KEY}"},
)
pages = response.json()["pages"] # discovered pages with their contentYou describe where to start and how far to go; the service runs the loop and returns the results.
Crawling API vs Scraping API
The two are related but scoped differently. A scraping API fetches and returns a single page you name. A crawling API discovers many pages by following links from a seed, then returns all of them. Put simply: scraping needs the URLs, crawling finds them. Many platforms offer both, and a crawl typically extracts content from each page it discovers.
When to Use One
Reach for a crawling API when you do not already have the URL list: mapping a documentation site, collecting every product in a category, or feeding a knowledge base from an entire section. If you already know the exact URLs, a scraping or extract call per URL is simpler and cheaper.
Key Takeaways
- A crawling API discovers and traverses a site from a seed URL through one endpoint.
- It manages the frontier, politeness, dedup, proxies, and retries for you.
- Use it when you need to find pages; use a scraping API when you already have URLs.
How ScrapeGraphAI Handles This
ScrapeGraphAI's crawl endpoint is exactly this: give it a start URL, depth, and scope, and it discovers the site's pages and extracts content from each, with proxies, politeness, and deduplication handled for you.