<?xml version="1.0" encoding="UTF-8"?>
<response><data><post><id>100</id><slug>when-to-use-an-api-instead-of-scraping-part-5-100</slug><title>When to use an API instead of scraping, part 5</title><excerpt>In part 5 we take the ideas from earlier instalments and apply them to a larger, messier site. If a site offers an API for the data you need, scraping its HTML is usually the harder, more fragile and…</excerpt><seriesName>When to use an API instead of scraping</seriesName><seriesPart>5</seriesPart><sections><item><heading>Introduction</heading><paragraphs><item>In part 5 we take the ideas from earlier instalments and apply them to a larger, messier site. If a site offers an API for the data you need, scraping its HTML is usually the harder, more fragile and less polite option.</item></paragraphs></item><item><heading>Common pitfalls</heading><paragraphs><item>Treat HTTP 429 responses as a signal, not an obstacle. Read the Retry-After header, back off, and resume at a slower pace.</item><item>Character encodings still cause trouble. Decode responses using the charset the server declares, and normalise text before comparing or storing it.</item></paragraphs></item><item><heading>A practical approach</heading><paragraphs><item>Be careful with relative URLs. Resolve every link against the page it came from, not against the site root, or you will request pages that do not exist.</item><item>Log every request with its URL, status code and duration. When something goes wrong at two in the morning, those logs are the difference between a quick fix and a long investigation.</item></paragraphs></item><item><heading>Key takeaway</heading><paragraphs><item>Check for a documented API, a data export or a feed first. Scrape only when none exists, and read the terms of service either way.</item></paragraphs></item></sections><authorId>9</authorId><authorName>Mateo Hughes</authorName><authorSlug>mateo-hughes</authorSlug><category>Ethics &amp; Law</category><tags><item>json</item><item>ethics</item><item>http</item><item>python</item></tags><publishedAt>2024-04-27T00:00:00.000Z</publishedAt><wordCount>170</wordCount><readingTimeMinutes>2</readingTimeMinutes></post></data></response>
