{"id":4393,"date":"2026-08-18T04:47:31","date_gmt":"2026-08-18T04:47:31","guid":{"rendered":"https:\/\/tucumandevelopers.com\/index.php\/2026\/08\/18\/the-day-our-scraper-fleet-shipped-nothing-and-the-afternoon-it-shipped-three\/"},"modified":"2026-08-18T04:47:31","modified_gmt":"2026-08-18T04:47:31","slug":"the-day-our-scraper-fleet-shipped-nothing-and-the-afternoon-it-shipped-three","status":"publish","type":"post","link":"https:\/\/tucumandevelopers.com\/index.php\/2026\/08\/18\/the-day-our-scraper-fleet-shipped-nothing-and-the-afternoon-it-shipped-three\/","title":{"rendered":"The day our scraper fleet shipped nothing \u2014 and the afternoon it shipped three"},"content":{"rendered":"
\n
<\/div>\n

What made it expensive was that the failure was invisible from inside the process. Every stage worked. The specs were fine, the tests were green, the pricing wired up correctly, the publisher refused correctly. The lane was healthy and the output was zero, which is the worst combination to debug because nothing is flashing red.<\/p>\n

<\/a> The afternoon that shipped three <\/h2>\n

We changed one variable: target class. Instead of marketplaces, we took three public research and regulatory APIs that require no key. Scaffold, implement, cloud QA, publish. Roughly an hour each, all three passed cloud QA on the first run.<\/p>\n

There is no clever trick here. A public JSON API has no incentive to fingerprint you, no CAPTCHA, no TLS fingerprint check, no HTML that gets rewritten on Tuesday. The whole class of failure that eats marketplace scrapers simply does not exist. What is left is ordinary engineering: paging, schema, and error handling.<\/p>\n

<\/a> Why is OpenAlex a good scraping target? <\/h2>\n

OpenAlex is the open replacement for Microsoft Academic Graph \u2014 roughly 250 million scholarly works, with authors, institutions, journals, citation counts and open-access status. It is free, it needs no API key, and it is genuinely well-behaved if you are.<\/p>\n

Two things matter in practice.<\/p>\n

Use cursor paging, not offset.<\/strong> Offset paging on a corpus this size falls apart past the first few thousand rows \u2014 the API caps how deep you can page and the cost of a deep offset grows. The cursor is the supported path: <\/p>\n

\n
GET https:\/\/api.openalex.org\/works?per-page=200&cursor=* <\/span><\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
Each response hands you meta.next_cursor<\/code>; you pass it back until it comes back null. Stateless, stable under concurrent updates, and it does not degrade at depth.<\/p>\n
Identify yourself and get the fast lane.<\/strong> OpenAlex runs a “polite pool” \u2014 include a contact in your User-Agent<\/code> or a mailto<\/code> parameter and your requests go to a separate, faster, more reliably-served pool. This is the rare case where telling the server who you are makes your scraper better<\/em>, not more blockable. We send our public contact URL, never a personal address.<\/p>\n
  <\/a> The trap that survived the easy target <\/h2>\n
Keyless does not mean trivial. The bug that cost us the most time on this batch had nothing to do with blocking.<\/p>\n
Apify Actors can declare a dataset schema, and ours declared fields like this: <\/p>\n
\n
{<\/span> <\/span>\"doi\"<\/span>:<\/span> <\/span>{<\/span> <\/span>\"type\"<\/span>:<\/span> <\/span>\"string\"<\/span> <\/span>}<\/span> <\/span>}<\/span> <\/span><\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
That is wrong, and it is wrong in the worst possible way: it only fails on a sparse<\/em> record. Scholarly metadata is extremely sparse \u2014 plenty of works have no DOI, no abstract, no ISSN, no funder. The first record missing one of those fields produces a null, the null fails validation, and push_data<\/code> dies mid-run. A fully-populated QA sample never triggers it, so the smoke test passes and the customer’s real query is what breaks.<\/p>\n
The fix is one character of JSON per field: <\/p>\n
\n
{<\/span> <\/span>\"doi\"<\/span>:<\/span> <\/span>{<\/span> <\/span>\"type\"<\/span>:<\/span> <\/span>[<\/span>\"string\"<\/span>,<\/span> <\/span>\"null\"<\/span>]<\/span> <\/span>}<\/span> <\/span>}<\/span> <\/span><\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
We fixed it at the scaffolder so no future Actor can be born with it. The general lesson: a QA fixture that is too clean is worse than no fixture<\/strong>, because it converts a loud failure into a delayed one.<\/p>\n
  <\/a> What this means for your backlog <\/h2>\n
Sort by class first:<\/p>\n
    \n
  1.  Keyless public APIs<\/strong> \u2014 ship first-attempt. Government registries, research indexes, open data portals, standards bodies. Low glamour, real buyers, and they do not fight back.<\/li>\n
  2.  Plain HTML sites with no commercial anti-bot<\/strong> \u2014 ship with ordinary care.<\/li>\n
  3.  Commercially defended marketplaces<\/strong> \u2014 only with a specific, tested plan for their defences, and a named tier you have actually probed. Never on optimism.<\/li>\n<\/ol>\n
    We ran category 3 on optimism for a long time. The scoreboard was honest about it exactly once, on the day it produced a zero.<\/p>\n
      <\/a> What the scraper actually does <\/h2>\n
    OpenAlex Works Scraper<\/a> searches the 250M-work catalogue and returns one flat row per work \u2014 title, DOI, authors with ORCIDs and affiliations, journal, publication date, citation count and open-access status \u2014 as JSON, CSV or Excel. It is pay-per-result at $2.05 per 1,000 rows<\/strong>, so a query that returns nothing costs you nothing beyond the start fee.<\/p>\n
    We are not going to pretend that any source stays static forever. APIs deprecate fields, tighten rate limits and reshape their pagination, and when OpenAlex does, absorbing that is our job, not yours \u2014 the cursor handling, the retries and the schema drift are on our side of the line.<\/p>\n
    If you work the same corpus from other angles, the neighbours are Crossref-adjacent research tooling<\/a>, arXiv<\/a> and EU CORDIS grants<\/a>.<\/p>\n
      <\/a> The rule we wrote down <\/h2>\n
    \n
    A backlog sorted only by revenue potential will happily spend a month on targets that cannot ship. Sort by target class first, then by revenue inside each class.<\/p>\n<\/blockquote>\n
    That is the whole finding. It cost us a zero-release day to learn, and it is the cheapest thing in this post to copy.<\/p>\n<\/p><\/div>\n<\/div>\n<\/div>\n<\/div>\n
    Fuente: Art\u00edculo original<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
    What made it expensive was that the failure was invisible from inside the process. Every stage worked. The specs were fine, the tests were green, the pricing wired up correctly, the publisher refused correctly. The lane was healthy and the output was zero, which is the worst combination to debug because nothing is flashing red. […]<\/p>\n","protected":false},"author":1,"featured_media":4392,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"webixso_pending_account_ids":""},"categories":[41],"tags":[],"class_list":["post-4393","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devto"],"jetpack_publicize_connections":[],"_links":{"self":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts\/4393","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/comments?post=4393"}],"version-history":[{"count":0,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/posts\/4393\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/media\/4392"}],"wp:attachment":[{"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/media?parent=4393"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/categories?post=4393"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tucumandevelopers.com\/index.php\/wp-json\/wp\/v2\/tags?post=4393"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}