Diaspore

All documents · source file docs/data-sources.md · changed 2026-10-26 · sha256 bd2c6224bc07

Data sources (all public)

sourceused foraccessnotes
OpenAlexpapers, authors, institutions, citationsfree API (api.openalex.org)good author disambiguation; use for citation counts with date filters
PubMed / E-utilitiesbiomedical papersfree APIPMIDs, MeSH terms
bioRxiv / medRxivpreprintsfree APIearliest signal
NIH RePORTERgrants incl. SBIR/STTRfree APIPI + institution + dates
PatentsViewUS patents and applicationsfree APIuse publication date for "knowable"
University TTO sitesavailable technologiesscrape politely, respect robots.txtsnapshot with content_hash
SEC EDGAR Form Dprivate financingsfreestrong outcome label for US startups
Company sites / pressorigins, foundersmanualevidence_url required
University TTO startup lists (incl. affiliated-hospital TTOs)IDEA-003 second S0 label source (labels_sec_tto_v2): annual "startups formed" pages, annual-report PDFs, portfolio pages, dated releases, free published startup countspublic pages only; scrape politely, respect robots.txt; login/form/paywall or paid AUTM data = skipped, listed in OWNER-QUEUEsources row + content_hash before parsing; raw to data/raw/tto/; data only in data/diaspore_tto.db, label-side only; rules in docs/prospective/labels-sec-tto-v2-spec.md (added 2026-10-25, nothing fetched yet)
Wayback Machine CDX API (web.archive.org/cdx)first-capture dates of TTO pages: knowability upper bound and survivorship check, never an event datefree APIsources row per query (IDEA-003)
SBIR.gov awards dataIDEA-003 financing protocol step 3: SBIR/STTR awards from all agencies (NIH cache covers NIH only)free public download; if it needs a login, form or payment, skipped and listed in OWNER-QUEUEsources row first; matched by norm_org (IDEA-003)
HESA register of UK university spin-outs (HE-BCI table 6, table-6.csv, linked from data.gov.uk)IDEA-009 GB S0 primary-label anchor and recall check: named spin-outs with Companies House registration number, provider, foundation and incorporation years, discipline (2,307 entries per the Sept 2025 update, founded 2012/13-2023/24; per UKRI / Jisc / TheDataCity docs, not yet read here)owner's manual browser download only: a scripted fetch got a Cloudflare JavaScript challenge (2026-10-25), which is never bypassed (OWNER-QUEUE row)raw to a new data/raw/hesa/YYYY-MM-DD/, sources row with sha256 first; licence expected CC BY 4.0 (TheDataCity), confirmed and quoted at IDEA-009 M6; attribution on the site; years are academic years, used for recall only, never dating; rules in docs/prospective/labels-gb-hesa-spec.md (added 2026-10-25, nothing fetched)
Companies House bulk company file (BasicCompanyData)IDEA-009: CRN join, SIC codes, incorporation date, status (live register snapshot)free keyless download from the CH bulk-data pageraw to a new data/raw/ch_bulk/YYYY-MM-DD/, sources row + sha256 first; holds live companies only, so dissolved CRNs are looked up per company (survivorship gap reported); parsed only by enrich/registry.py (raw-cache guard); licence (expected Open Government Licence) quoted at M3
Companies House public company pages (find-and-update.company-information.service.gov.uk: officers, PSC, filing history)IDEA-009: officer, PSC and filing records per CRN; knowability = filing date of the naming record, never appointed_onpublic pages, no key, at <= 1 request/sraw to data/raw/ch_pages/<CRN>/, sources row + content_hash per page; birth month/year and non-officer shareholder names are match evidence only, never displayed (hard rule 8)
Companies House filing documents (IN01, CS01 PDFs via the public filing history)IDEA-009: IN01 subscribers and first-CS01 shareholder lists (present / absent / unreadable)public, no key; text extraction only, no OCRraw to data/raw/ch_docs/, sources row + content_hash; scanned / unreadable files recorded as unreadable, never imputed
Companies House API and Document APIIDEA-009 R1b officer name search; R2 per-CRN loads at scalefree key, registration off-machine (OWNER-QUEUE); not used until the key existssame sources / raw rules as the public pages; rate limit not binding at planned volumes
UKRI Gateway to ResearchIDEA-009 R3 country-native model (family b) and R5 grant denominators: UK grants with PI names, dated by start datefree public API (not yet fetched)sources row first; features only through gate.split, behind their own leakage audit
UK Register of Learning Providers (UKRLP; ukrlp.education.gov.uk, www.ukrlp.co.uk redirects there)IDEA-009 addendum 3 I1: does a GB education child of a ranked panel institution have its own UKPRN, active at the window cutoffpublic keyless search form (POST /Home/Search with the page's anti-forgery token) and public provider pages; sign-in is only for providers editing their own record and is never usedsources row per lookup (search URL + query, provider page URL as evidence); provider status never from HESA or HE-BCI; terms and robots below
OfS Register (register.officeforstudents.org.uk, data from register-api.officeforstudents.org.uk)IDEA-009 addendum 3 I1 fallback for English providers when UKRLP gives no answerpublic keyless page and the JSON API its page callssources row per lookup; terms and robots below

Never use: employer-internal data, paid databases accessed through an employer, non-public information.

UKRLP and OfS Register: terms and robots.txt (quoted 2026-10-26, before the first lookup)

Internet Archive snapshots and HEFCE publications (row added 2026-10-26, addendum-4 conformance m5)

sourceused foraccessnotes
Internet Archive Wayback snapshots (https://web.archive.org/web/<timestamp>id_/<original URL>) and HEFCE publications read through them (e.g. HEFCE 2014/04 Annex A, hefce.ac.uk/media/hefce/content/pubs/2014/201404/HEFCE2014_04a.xlsx)IDEA-009 addendum 4 J4: a dated public record that a provider existed under its own UKPRN or name on or before a GB cutoff (the capture timestamp dates the copy; the content is the publisher's own file). Never an event date for a labelfree, keyless; id_ returns the archived bytes unmodified; one request at a time with a pausesources row + content_hash per snapshot (gb-s0-2019 DB rows 219, 221, 268). robots.txt: https://web.archive.org/robots.txt returned HTTP 404 when checked 2026-10-26 (nothing disallowed; no sources row then, see decisions.md 2026-10-26 m4 convention). Terms: Internet Archive terms of use and the HEFCE licence (HEFCE closed 2018; successor OfS / UKRI) are not yet quoted here; quote both before the next snapshot fetch. Use is limited to provider names, UKPRNs and dates; no content is republished.

Companies House: terms and robots.txt (quoted 2026-10-26, before the first CH data request; IDEA-009 M3)

Fetched by enrich/registry.py (Fetcher, User-Agent "diaspore-research/0.3 (public-data research project, IDEA-009; no contact address)", <= 1 request/s), each with a sources row in data/diaspore_registry.db (rows 1-17; status per request in data/raw/ch_robots/fetch_log.jsonl, bodies saved there). Only these robots.txt and terms pages were requested before this section was written.