Pricing

from $3.00 / 1,000 company records

Try for free

Go to Apify Store

OpenCorporates Scraper

Try for free

Scrape OpenCorporates company records from 140+ jurisdictions by country or state code, or by company URL. Get status, type, address, industry codes, EIN/CIK, previous names, filings and officer counts. Add your own OpenCorporates login for directors, owners and incorporation dates.

Pricing

from $3.00 / 1,000 company records

Rating

0.0

(0)

Developer

Muhamed Didovic

Actor stats

Bookmarked

Total users

Monthly active users

17 hours ago

Last modified

Instagram Scraper

apify/instagram-scraper

Extract Instagram posts, reels, profiles, places, hashtags, carousels, and comments. Get data from Instagram using one or more Instagram URLs or search queries: content, context, metrics, metadata. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.

Apify

457K

4.7

(603)

TikTok Scraper

clockworks/tiktok-scraper

Extract data from TikTok videos, hashtags, and users. Use URLs or search queries to scrape TikTok profiles, hashtags, posts, URLs, shares, followers, hearts, names, video, and music-related data. Export scraped data, run the scraper via API, schedule and monitor runs or integrate with other tools.

Clockworks

369K

4.7

(370)

Google Maps Scraper

compass/crawler-google-places

Extract data from thousands of Google Maps locations and businesses, including reviews, reviewer details, images, contact info, including full name, email, and job title, opening hours, prices & more. Export data, run via API, schedule and monitor runs, or integrate with other tools.

Compass

673K

4.7

(1,820)

Tweet Scraper V2 - X Scraper / Twitter Scraper / X.com Scraper

apidojo/tweet-scraper

Lightning-fast search, URL, list, and profile scraping, with customizable filters. At $0.40 per 1000 tweets, and 30-80 tweets per second, it is ideal for researchers, entrepreneurs, and businesses! Get comprehensive insights from Twitter (X) now!

API Dojo

124K

3.9

(196)

Instagram Profile Scraper (Bio & Posts)

coderx/instagram-profile-scraper-bio-posts

Instagram Profile Insights Scraper is a lightweight tool that collects detailed public data from a list of Instagram usernames. It fetches profile info and recent posts to help you analyze accounts at scale.

CoderX

11K

5.0

(9)

Instagram Profile Scraper

apify/instagram-profile-scraper

Scrape all Instagram profile info. Just add Instagram usernames, IDs or URLs and extract name, join date, number of followers, location, bio, website, related profiles, video&post count, latest posts. Export scraped data, schedule scraper via API, and integrate with other tools or AI workflows.

Apify

268K

4.7

(175)

Google Search Results Scraper

apify/google-search-scraper

Scrape Google Search Engine Results Pages (SERPs). Select the country or language and extract organic and paid results, AI Mode, AI overviews, ads, queries, People Also Ask, prices, reviews, like a Google SERP API. Export data, run the scraper via API, schedule runs, or integrate with other tools.

Apify

221K

4.6

(220)

LinkedIn Profile Scraper + Email (No Cookies)

harvestapi/linkedin-profile-scraper

Extract detailed information from LinkedIn profiles in bulk, including complete work experience, education history, skills and more. No cookies or account required.

HarvestAPI

90K

4.6

(93)

Posts Search Scraper for LinkedIn | No Cookies

apimaestro/linkedin-posts-search-scraper-no-cookies

Scrape LinkedIn posts by keyword without login. Get post content, reactions, author details, and media. Sort by relevance or date. Perfect for research, analysis, and monitoring trends.

API Maestro

16K

4.7

(36)

Instagram Post Scraper

apify/instagram-post-scraper

Scrape Instagram posts. Just add one or more Instagram usernames and get your data in seconds including caption, metrics, images, mentions, coauthors, recent comments, sponsored status, video duration, views. Export scraped data, schedule scraper via API, integrate with other tools or AI workflows.

Apify

150K

4.3

(139)

.gitignore

node_modules/
dist/
*.tsbuildinfo
.DS_Store
.env
storage/

Dockerfile

# Specify the base Docker image. You can read more about
# the available images at https://crawlee.dev/docs/guides/docker-images
# You can also use any other image from Docker Hub.
FROM apify/actor-node:24 AS builder

# Check preinstalled packages
RUN npm ls @crawlee/core apify puppeteer playwright

# Copy just package.json and package-lock.json
# to speed up the build using Docker layer cache.
COPY --chown=myuser:myuser package*.json ./

# Install all dependencies. Don't audit to speed up the installation.
RUN npm install --include=dev --audit=false

# Next, copy the source files using the user set
# in the base image.
COPY --chown=myuser:myuser . ./

# Install all dependencies and build the project.
# Don't audit to speed up the installation.
# A stray tsbuildinfo in the upload makes incremental tsc skip emitting into the
# empty dist and exit 0 (partial image, MODULE_NOT_FOUND at runtime) — delete it.
RUN rm -f tsconfig.tsbuildinfo *.tsbuildinfo dist/*.tsbuildinfo && npm run build && node --input-type=module -e "import('node:fs').then(fs=>{if(!fs.existsSync('dist/main.js')){console.error('dist incomplete');process.exit(1)}})"

# Create final image
FROM apify/actor-node:24

# impers downloads libcurl-impersonate from GitHub the first time it loads, and by
# default it takes the newest release. From v2.2.3 that library bundles c-ares and
# exports its symbols. Node 22.23.4 and 24.22.1 (in the apify/actor-node images of
# 2026-10-21) carry c-ares 1.34.9, and Node's copy overrides the library's own, so
# every impers request fails its DNS lookup: "Transfer failed with code 5" through
# a proxy, code 28 direct. v2.2.2 has no c-ares and sends the same fingerprints.
ENV IMPER_LIBCURL_RELEASE_URL=https://api.github.com/repos/lexiforest/curl-impersonate/releases/tags/v2.2.2

# The base image sets NODE_OPTIONS=--max_old_space_size=30000 — a 30 GB V8 heap limit inside
# whatever cgroup the run actually gets (512 MB by default). With a limit that far away V8 never
# bothers to collect, per-input garbage piles up, and large runs die with exit 137 while the live
# heap is flat — it reads as a leak and is not one. Dropping the flag lets Node apply its own
# cgroup-aware default, about half the container: measured 259 MB at 512, 524 at 1024, 1048 at 2048.
ENV NODE_OPTIONS=--max-http-header-size=80000

# Check preinstalled packages
RUN npm ls @crawlee/core apify puppeteer playwright

# Copy just package.json and package-lock.json
# to speed up the build using Docker layer cache.
COPY --chown=myuser:myuser package*.json ./

# apify/actor-node ships /usr/src/app and /pkg-cache/npm root-owned, while the
# install below runs as myuser — without this it fails EACCES, either renaming a
# preinstalled @apify package or rewriting package-lock.json. A failed build keeps
# the previous one tagged latest, so the actor silently stays on old code.
USER root
RUN mkdir -p /pkg-cache/npm && chown -R myuser:myuser /pkg-cache/npm /usr/src/app 2>/dev/null || true
USER myuser

# Install NPM packages, skip optional and development dependencies to
# keep the image small. Avoid logging too much and print the dependency
# tree for debugging
RUN npm --quiet set progress=false \
    # && npm install --omit=dev --omit=optional \
    && npm install --omit=dev \
    && echo "Installed NPM packages:" \
    && (npm list --omit=dev --all || true) \
    && echo "Node.js version:" \
    && node --version \
    && echo "NPM version:" \
    && npm --version \
    && rm -r ~/.npm

# Copy built JS files from builder image
COPY --from=builder --chown=myuser:myuser /usr/src/app/dist ./dist

# Next, copy the remaining files and directories with the source code.
# Since we do this after NPM install, quick build will be really fast
# for most source file changes.
COPY --chown=myuser:myuser . ./

# Run the image.
CMD ["node", "dist/main.js"]

eslint.config.mjs

1import prettier from 'eslint-config-prettier';
2
3import apify from '@apify/eslint-config/ts.js';
4import globals from 'globals';
5import tsEslint from 'typescript-eslint';
6
7// eslint-disable-next-line import/no-default-export
8export default [
9    {
10        ignores: [
11            '**/dist',
12            'eslint.config.mjs',
13            // Fleet-shared vendored modules: copied verbatim into hundreds of actors and kept
14            // byte-identical so a fix can be propagated by copy. Never lint-fix them inside a
15            // single actor -- change them at the shared source and re-sync.
16            '**/runTelemetry.ts',
17            '**/telegram.ts',
18            '**/concurrency.ts',
19            '**/apify-telegram-lifecycle.ts',
20            // Email-enrichment module: canonical source is ~/projects/shared-email-enrich/,
21            // stamped in by sync-enrich.sh. Edit there, never here.
22            '**/enrichEmails.ts',
23            '**/rocketreach.ts',
24            '**/rocketreachApi.ts',
25        ],
26    },
27    ...apify,
28    prettier,
29    {
30        languageOptions: {
31            parser: tsEslint.parser,
32            parserOptions: {
33                project: 'tsconfig.json',
34            },
35            globals: {
36                ...globals.node,
37                ...globals.jest,
38            },
39        },
40        plugins: {
41            '@typescript-eslint': tsEslint.plugin,
42        },
43        rules: {
44            'no-console': 0,
45        },
46    },
47];

package.json

{
    "name": "apify-opencorporates-scraper",
    "version": "1.0.0",
    "description": "OpenCorporates company records by jurisdiction or company URL, with optional officers via the user's own login.",
    "main": "dist/main.js",
    "type": "module",
    "scripts": {
        "start": "npm run start:dev",
        "start:dev": "tsx src/main.ts",
        "build": "tsc",
        "lint": "eslint src --ext .ts",
        "test": "tsx --test test/*.test.ts"
    },
    "author": "memo23",
    "license": "ISC",
    "dependencies": {
        "apify": "^3.7.0",
        "cheerio": "^1.2.0",
        "crawlee": "^3.16.0",
        "impers": "^0.0.5",
        "impit": "^0.14.5",
        "node-telegram-bot-api": "^0.67.0"
    },
    "devDependencies": {
        "@apify/eslint-config": "^2.0.6",
        "@apify/eslint-config-ts": "^0.4.1",
        "@apify/tsconfig": "^0.1.1",
        "@types/node-telegram-bot-api": "^0.64.14",
        "eslint": "^9.33.0",
        "eslint-config-prettier": "^10.1.8",
        "globals": "^17.8.0",
        "tsx": "^4.20.4",
        "typescript": "^5.9.2",
        "typescript-eslint": "^8.65.0"
    },
    "apify": {
        "name": "opencorporates-scraper"
    }
}

tsconfig.json

{
    "extends": "@apify/tsconfig",
    "compilerOptions": {
        "incremental": false,
        "module": "NodeNext",
        "moduleResolution": "NodeNext",
        "target": "ES2022",
        "outDir": "dist",
        "noUnusedLocals": false,
        "skipLibCheck": true,
        "lib": ["DOM"]
    },
    "include": ["./src/**/*"]
}

.actor/actor.json

{
	"actorSpecification": 1,
    "name": "opencorporates-scraper",
    "title": "OpenCorporates Scraper",
    "description": "Scrape OpenCorporates company records from 140+ jurisdictions by country or state code, or by company URL. Get status, type, address, industry codes, EIN/CIK, previous names, filings and officer counts. Optional officer enrichment adds directors, owners and incorporation dates — no account needed on your side.",
    "version": "0.0",
    "meta": {
        "templateId": "ts-crawlee-cheerio"
    },
    "input": "./input_schema.json",
    "output": "./output_schema.json",
    "storages": {
        "dataset": "./dataset_schema.json"
    },
    "dockerfile": "../Dockerfile",
    "minMemoryMbytes": 512,
    "maxMemoryMbytes": 1024
}

.actor/dataset_schema.json

{
    "actorSpecification": 1,
    "fields": {},
    "views": {
        "overview": {
            "title": "Companies",
            "transformation": {
                "fields": [
                    "name",
                    "companyNumber",
                    "jurisdictionCode",
                    "status",
                    "companyType",
                    "incorporationDate",
                    "registeredAddress",
                    "industryCodes",
                    "officersCount",
                    "url"
                ]
            },
            "display": {
                "component": "table",
                "properties": {
                    "name": { "label": "Name", "format": "text" },
                    "companyNumber": { "label": "Company number", "format": "text" },
                    "jurisdictionCode": { "label": "Jurisdiction", "format": "text" },
                    "status": { "label": "Status", "format": "text" },
                    "companyType": { "label": "Type", "format": "text" },
                    "incorporationDate": { "label": "Incorporated", "format": "text" },
                    "registeredAddress": { "label": "Registered address", "format": "text" },
                    "industryCodes": { "label": "Industry codes", "format": "array" },
                    "officersCount": { "label": "Officers", "format": "number" },
                    "url": { "label": "OpenCorporates", "format": "link" }
                }
            }
        },
        "people": {
            "title": "Officers and owners",
            "transformation": {
                "fields": ["name", "companyNumber", "jurisdictionCode", "directorsOfficers", "beneficialOwners", "url"]
            },
            "display": {
                "component": "table",
                "properties": {
                    "name": { "label": "Company", "format": "text" },
                    "companyNumber": { "label": "Company number", "format": "text" },
                    "jurisdictionCode": { "label": "Jurisdiction", "format": "text" },
                    "directorsOfficers": { "label": "Directors / officers", "format": "array" },
                    "beneficialOwners": { "label": "Beneficial owners", "format": "array" },
                    "url": { "label": "OpenCorporates", "format": "link" }
                }
            }
        }
    }
}

.actor/input_schema.json

{
    "title": "OpenCorporates Scraper",
    "description": "Company records from OpenCorporates by jurisdiction code (gb, us_ca, fr, ...) or by company URL. Optional officer enrichment adds directors, officers and incorporation dates — no account needed on your side.",
    "type": "object",
    "schemaVersion": 1,
    "properties": {
        "jurisdictions": {
            "sectionCaption": "What to scrape",
            "title": "Jurisdictions",
            "type": "array",
            "description": "Jurisdiction codes: a two-letter country (gb, fr, nl, fi) or country_state (us_ca, us_ny, ca_on). A country code alone (us, ca) matches all of its states and provinces.",
            "editor": "stringList",
            "prefill": ["gb"]
        },
        "startUrls": {
            "title": "Company URLs",
            "type": "array",
            "description": "OpenCorporates company pages, e.g. https://opencorporates.com/companies/gb/05957738. Use this to look up specific companies. Can be combined with jurisdictions.",
            "editor": "stringList"
        },
        "includeOfficers": {
            "sectionCaption": "Officer enrichment (optional)",
            "sectionDescription": "OpenCorporates shows directors, officers and incorporation dates only to signed-in users. Off by default. Turn it on and the scraper signs in with its own accounts and adds those fields to each company. No OpenCorporates account needed on your side. Charged additionally per enriched record.",
            "title": "Include directors and officers",
            "type": "boolean",
            "description": "Add directors, officers, beneficial owners and incorporation dates to each company record. Charged additionally per enriched record, on top of the base company record. Rows that could not be enriched come with the public fields and no enrichment charge.",
            "default": false
        },
        "maxItems": {
            "title": "Maximum companies",
            "type": "integer",
            "description": "Stop after this many company records. Each record is one billed result (plus the enrichment charge if officers are on).",
            "default": 1000,
            "minimum": 1
        },
        "startOffset": {
            "title": "Skip first companies",
            "type": "integer",
            "description": "Skip this many companies of the jurisdictions above, to continue where an earlier run stopped (e.g. 1000 after a run of 1000). Company URLs are never skipped. The order can change when OpenCorporates updates its listings, so a long-ago offset may repeat or miss some companies.",
            "default": 0,
            "minimum": 0
        },
        "maxConcurrency": {
            "sectionCaption": "Advanced",
            "title": "Max concurrency",
            "type": "integer",
            "description": "How many company pages to load in parallel.",
            "default": 15,
            "minimum": 1,
            "maximum": 20
        },
        "recordMaxAgeDays": {
            "title": "Reuse recent results (days)",
            "type": "integer",
            "description": "Companies collected for any run in the last N days are returned at once instead of being loaded again; each row's scrapedAt shows when it was collected. Set 0 to always load fresh data.",
            "default": 30,
            "minimum": 0,
            "maximum": 30
        },
        "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Leave empty to use the built-in residential proxy.",
            "editor": "proxy"
        }
    },
    "required": []
}

.actor/output_schema.json

{
    "actorOutputSchemaVersion": 1,
    "title": "OpenCorporates Scraper Output",
    "properties": {
        "overview": {
            "type": "string",
            "title": "Companies",
            "template": "{{links.apiDefaultDatasetUrl}}/items?view=overview"
        },
        "people": {
            "type": "string",
            "title": "Officers and owners",
            "template": "{{links.apiDefaultDatasetUrl}}/items?view=people"
        }
    }
}

readme-stuff/how-it-works-opencorporates.png

readme-stuff/how-it-works-opencorporates.svg

1<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 3200 1800" width="3200" height="1800" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif">
2  <rect width="3200" height="1800" fill="#0f172a"/>
3  <g transform="translate(0,150)">
4  <text x="1600" y="130" text-anchor="middle" fill="#f8fafc" font-size="68" font-weight="700">OpenCorporates Scraper</text>
5  <text x="1600" y="196" text-anchor="middle" fill="#94a3b8" font-size="34">Company registry records from 140+ jurisdictions, one row per company</text>
6
7  <rect x="120" y="300" width="800" height="1080" rx="24" fill="#1e293b" stroke="#334155" stroke-width="2"/>
8  <text x="520" y="385" text-anchor="middle" fill="#38bdf8" font-size="44" font-weight="600">1. You choose</text>
9  <rect x="190" y="450" width="660" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
10  <text x="230" y="510" fill="#e2e8f0" font-size="32">Jurisdictions</text>
11  <text x="230" y="560" fill="#94a3b8" font-size="27">gb, fr, nl, us_ca, us_ny, ca_on ...</text>
12  <rect x="190" y="630" width="660" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
13  <text x="230" y="690" fill="#e2e8f0" font-size="32">or company URLs</text>
14  <text x="230" y="740" fill="#94a3b8" font-size="27">look up specific companies</text>
15  <rect x="190" y="810" width="660" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
16  <text x="230" y="870" fill="#e2e8f0" font-size="32">Maximum companies</text>
17  <text x="230" y="920" fill="#94a3b8" font-size="27">pay only for rows you get</text>
18  <rect x="190" y="990" width="660" height="180" rx="16" fill="#0f172a" stroke="#38bdf8" stroke-dasharray="10 8"/>
19  <text x="230" y="1050" fill="#e2e8f0" font-size="32">Your OpenCorporates login</text>
20  <text x="230" y="1100" fill="#94a3b8" font-size="27">optional: adds directors,</text>
21  <text x="230" y="1140" fill="#94a3b8" font-size="27">owners and incorporation dates</text>
22
23  <polygon points="1040,930 960,890 960,970" fill="#38bdf8"/>
24
25  <rect x="1080" y="300" width="1040" height="1080" rx="24" fill="#1e293b" stroke="#334155" stroke-width="2"/>
26  <text x="1600" y="385" text-anchor="middle" fill="#a78bfa" font-size="44" font-weight="600">2. The actor collects</text>
27  <rect x="1150" y="450" width="900" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
28  <text x="1190" y="510" fill="#e2e8f0" font-size="32">Finds companies in your jurisdictions</text>
29  <text x="1190" y="560" fill="#94a3b8" font-size="27">active and dissolved, no search terms needed</text>
30  <rect x="1150" y="630" width="900" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
31  <text x="1190" y="690" fill="#e2e8f0" font-size="32">Reads each company record</text>
32  <text x="1190" y="740" fill="#94a3b8" font-size="27">every field the page shows</text>
33  <rect x="1150" y="810" width="900" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
34  <text x="1190" y="870" fill="#e2e8f0" font-size="32">Cleans and structures it</text>
35  <text x="1190" y="920" fill="#94a3b8" font-size="27">ISO dates, address lines, typed identifiers</text>
36  <rect x="1150" y="990" width="900" height="150" rx="16" fill="#0f172a" stroke="#475569"/>
37  <text x="1190" y="1050" fill="#e2e8f0" font-size="32">Retries failed pages automatically</text>
38  <text x="1190" y="1100" fill="#94a3b8" font-size="27">removed or empty pages are skipped, not billed</text>
39
40  <polygon points="2240,930 2160,890 2160,970" fill="#a78bfa"/>
41
42  <rect x="2280" y="300" width="800" height="1080" rx="24" fill="#1e293b" stroke="#334155" stroke-width="2"/>
43  <text x="2680" y="385" text-anchor="middle" fill="#34d399" font-size="44" font-weight="600">3. You get</text>
44  <g font-size="29" fill="#e2e8f0">
45    <rect x="2350" y="450" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="505">name, number, status, type</text>
46    <rect x="2350" y="556" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="611">registered address</text>
47    <rect x="2350" y="662" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="717">industry codes (SIC / NACE)</text>
48    <rect x="2350" y="768" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="823">EIN, CIK, previous names</text>
49    <rect x="2350" y="874" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="929">agent, filings, accounts dates</text>
50    <rect x="2350" y="980" width="660" height="86" rx="12" fill="#0f172a" stroke="#475569"/><text x="2390" y="1035">officer and owner counts</text>
51    <rect x="2350" y="1086" width="660" height="86" rx="12" fill="#0f172a" stroke="#34d399" stroke-dasharray="10 8"/><text x="2390" y="1141">with login: officers + dates</text>
52  </g>
53  <text x="2680" y="1250" text-anchor="middle" fill="#94a3b8" font-size="30">JSON, CSV, Excel</text>
54  <text x="2680" y="1300" text-anchor="middle" fill="#94a3b8" font-size="30">API, webhooks, schedules</text>
55</g>
56</svg>

readme-stuff/how-it-works-opencorporates@2x.png

readme-stuff/logo.png

readme-stuff/logo.svg

1<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512">
2  <defs>
3    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
4      <stop offset="0" stop-color="#1e3a8a"/>
5      <stop offset="1" stop-color="#0f172a"/>
6    </linearGradient>
7  </defs>
8  <rect width="512" height="512" rx="96" fill="url(#bg)"/>
9  <!-- registry building -->
10  <polygon points="96,196 256,108 416,196" fill="#e2e8f0"/>
11  <rect x="96" y="196" width="320" height="22" fill="#cbd5e1"/>
12  <g fill="#e2e8f0">
13    <rect x="122" y="232" width="34" height="132" rx="6"/>
14    <rect x="190" y="232" width="34" height="132" rx="6"/>
15    <rect x="258" y="232" width="34" height="132" rx="6"/>
16  </g>
17  <rect x="96" y="376" width="240" height="26" rx="4" fill="#cbd5e1"/>
18  <!-- magnifier -->
19  <circle cx="356" cy="318" r="62" fill="#0f172a" stroke="#38bdf8" stroke-width="22"/>
20  <line x1="400" y1="362" x2="446" y2="408" stroke="#38bdf8" stroke-width="28" stroke-linecap="round"/>
21  <g fill="#38bdf8">
22    <rect x="326" y="296" width="60" height="10" rx="5"/>
23    <rect x="326" y="314" width="44" height="10" rx="5"/>
24    <rect x="326" y="332" width="52" height="10" rx="5"/>
25  </g>
26</svg>

readme-stuff/logo@2x.png

src/main.ts

1import { gunzipSync } from 'node:zlib';
2
3import { Actor, Dataset, log } from 'apify';
4import { load as loadHtml } from 'cheerio';
5import { Impit } from 'impit';
6
7import { loginAll, loginBuiltin } from './lib/auth.js';
8import { runWithGlobalSlidingWindow } from './lib/concurrency.js';
9import { registerFailureAlertWebhook } from './lib/failureAlertWebhook.js';
10import { isChallenge, normalizeCompanyUrl,parseCompanyDetails } from './lib/parser.js';
11import { configureRecordStore, listRefreshCandidates, markServed, purgeRecords, readRecords, recordCounters, writeRecords } from './lib/recordStore.js';
12import { createProxyConfigurationWithFallback, EVOMI_URL } from './lib/residentialFallback.js';
13import { finishRunTelemetry,initRunTelemetry } from './lib/runTelemetry.js';
14import { SHARD_HINTS } from './lib/shardHints.js';
15import type { Credential, Input } from './types/inputs.js';
16
17const BASE = 'https://opencorporates.com';
18const MAX_ATTEMPTS = 4;
19/** Requests one connection serves before it is replaced. */
20const MAX_CONNECTION_USES = 20;
21
22// Parsed company rows shared across runs and customers (shared-record-store).
23// Signed-out rows and enriched rows are kept apart: an enriched run only serves
24// enriched rows, a plain run only plain ones, so nobody gets fields they did
25// not ask (or pay) for. Bump RECORD_SCHEMA when the row shape changes.
26const RECORD_SCHEMA = 1;
27const RECORD_SOURCE_PLAIN = 'oc';
28const RECORD_SOURCE_ENRICHED = 'oc-enriched';
29const DAY_MS = 24 * 60 * 60 * 1000;
30configureRecordStore({
31    url: 'libsql://opencorporates-records-memo23.aws-eu-west-1.turso.io',
32    token: 'eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJhIjoicnciLCJpYXQiOjE3OTMzODE5NDIsImlkIjoiMDFhMThkZTQtYmMwMS03OGMzLWJmNDUtZWJkMTMxZTFlNGI3Iiwia2lkIjoiVl91dlNWcHozZUlOVExCeXpUOXNYVjhjZkNsQnVITEtDT0VkaGlDNmt1byIsInJpZCI6Ijc1ZGM1YzdiLWQxMTctNGNkZi1iZTAzLWJkNjU1MDhjODAyMSJ9.XeExdnzyvSz772afAzgmkarTDPzmXH2FgAYJd_Z3ip9qsmakRJcZL3X0VOoWVKYsbFOn-URmxh7C6wfNVfdqDw',
33});
34// Daily store maintenance (owner-only `refreshStore` runs, started by an Apify schedule):
35// delete rows not confirmed for 90 days, and re-fetch rows that customers keep asking for
36// shortly before they stop being served (25-30 days old, served twice or more in 30 days).
37const OWNER_USER_ID = 'ngn8vRESTkseyWE6p';
38const PURGE_AFTER_DAYS = 90;
39const REFRESH_FROM_DAYS = 25;
40const REFRESH_MIN_SERVES = 2;
41/** "https://opencorporates.com/companies/gb/05957738" -> "gb/05957738" */
42const entityIdOf = (url: string): string => url.replace(/^https:\/\/opencorporates\.com\/companies\//, '');
43
44class HttpError extends Error {
45    constructor(readonly status: number, url: string) {
46        super(`${status} on ${url}`);
47    }
48}
49
50const decode = (buf: Buffer): string =>
51    // impit sometimes auto-decompresses; only gunzip if the gzip magic is present
52    (buf.length > 2 && buf[0] === 0x1f && buf[1] === 0x8b ? gunzipSync(buf) : buf).toString('utf-8');
53
54await Actor.init();
55await initRunTelemetry();
56await registerFailureAlertWebhook('opencorporates');
57
58try {
59    const input = await Actor.getInput<Input>();
60    const user = {
61        id: process.env.APIFY_USER_ID || '',
62        isPaying: process.env.APIFY_USER_IS_PAYING === '1',
63    };
64
65    let jurisdictions = (input?.jurisdictions ?? []).map((j) => String(j).trim().toLowerCase()).filter(Boolean);
66    const startUrls: string[] = [];
67    for (const raw of input?.startUrls ?? []) {
68        // Accept plain strings and Apify's {url} request objects.
69        const value = typeof raw === 'string' ? raw : (raw as { url?: string })?.url ?? '';
70        if (!value.trim()) continue;
71        const url = normalizeCompanyUrl(value);
72        if (url) startUrls.push(url);
73        else log.warning(`[INPUT] skipping "${value.slice(0, 120)}" - not an opencorporates.com/companies/{jurisdiction}/{number} URL`);
74    }
75    const credentials: Credential[] = [];
76    if (input?.loginEmail && input?.loginPassword) {
77        credentials.push({ username: input.loginEmail.trim(), password: input.loginPassword });
78    }
79    for (const c of input?.credentials ?? []) {
80        // Older inputs: {username, password} pairs, or {key, value} from a key-value editor.
81        const username = c.username ?? (c as { key?: string }).key;
82        const password = c.password ?? (c as { value?: string }).value;
83        if (username && password) credentials.push({ username, password });
84    }
85    const includeOfficers = input?.includeOfficers ?? false;
86    const maxConcurrency = Math.max(1, Math.min(20, input?.maxConcurrency ?? 15));
87    const recordMaxAgeDays = Math.max(0, Math.min(30, input?.recordMaxAgeDays ?? 30));
88    const startOffset = Math.max(0, Math.floor(Number(input?.startOffset) || 0));
89    let maxItems = input?.maxItems ?? 1000;
90
91    if (!user.isPaying) {
92        maxItems = Math.min(maxItems, 100);
93        log.info('Non-paying user — capped at 100 items.');
94    }
95    if (user.id === 'public-actors-automated-tests') {
96        maxItems = 1;
97    }
98
99    // Codes never seen in the sitemap would cost a scan of hundreds of shards to find nothing.
100    const knownCodes = Object.keys(SHARD_HINTS);
101    const isKnown = (j: string) => knownCodes.some((k) => k === j || k.startsWith(`${j}_`));
102    const unknown = jurisdictions.filter((j) => !isKnown(j));
103    if (unknown.length) {
104        const countries = knownCodes.filter((k) => !k.includes('_')).join(', ');
105        const msg = `Unknown jurisdiction code(s): ${unknown.join(', ')}. Use a two-letter country (${countries}) or country_state (us_ca, ca_on, ...).`;
106        if (unknown.length === jurisdictions.length && !startUrls.length) throw new Error(msg);
107        log.warning(`[INPUT] ${msg} Ignoring them.`);
108        jurisdictions = jurisdictions.filter(isKnown);
109    }
110
111    // Owner-only maintenance run. Anyone else passing the flag gets an ordinary run.
112    const refreshMode = input?.refreshStore === true && (user.id === OWNER_USER_ID || !process.env.APIFY_IS_AT_HOME);
113    if (input?.refreshStore === true && !refreshMode) log.warning('[INPUT] refreshStore is not available - ignoring it');
114
115    if (!refreshMode && !jurisdictions.length && !startUrls.length) {
116        throw new Error('Provide at least one jurisdiction code (e.g. gb) or one opencorporates.com company URL.');
117    }
118
119    const proxyConfiguration = await createProxyConfigurationWithFallback(
120        (input?.proxy as any) ?? { useApifyProxy: false, proxyUrls: [EVOMI_URL] },
121        { forceFallback: input?.debugForceProxyFallback === true },
122    );
123    // Ask for a URL per request so a mid-run switch to the backup proxy takes effect.
124    const nextProxyUrl = async (): Promise<string | undefined> => (proxyConfiguration ? (await proxyConfiguration.newUrl()) ?? undefined : undefined);
125
126    // Optional: a logged-in session adds directors/officers, incorporation and
127    // dissolution dates, beneficial owners and the official registry source.
128    // Without it the actor still returns every field shown to anonymous visitors.
129    // Operator-owned account pool is used when officer enrichment is on; a
130    // customer-supplied login (loginEmail/loginPassword) takes priority.
131    //
132    // Each OpenCorporates account answers 429 after roughly a hundred signed-in
133    // page views. When that happens we move to the next pool account, and once
134    // the pool is used up the run carries on signed out, at full speed, without
135    // the enrichment charge.
136    let sessionCookie: string | undefined;
137    const enrichmentOn = includeOfficers;
138    let usePool = enrichmentOn && !credentials.length;
139    const triedAccounts = new Set<string>();
140
141    const signInFromPool = async (): Promise<boolean> => {
142        const proxyUrl = await nextProxyUrl();
143        const imp = new Impit({ browser: 'chrome', http3: false, proxyUrl, timeout: 20000 });
144        try {
145            const s = await loginBuiltin(imp, proxyUrl, triedAccounts);
146            sessionCookie = s?.cookie;
147            return Boolean(s);
148        } finally {
149            try { (imp as any).close?.(); } catch {}
150        }
151    };
152
153    if (usePool) {
154        log.info('[AUTH] signing in to OpenCorporates for officer enrichment');
155        if (await signInFromPool()) log.info('[AUTH] signed in - directors and officers will be included');
156        else log.warning('[AUTH] sign-in unavailable - continuing without officers (not charged)');
157    } else if (credentials.length) {
158        log.info('[AUTH] signing in to OpenCorporates');
159        const proxyUrl = await nextProxyUrl();
160        const imp = new Impit({ browser: 'chrome', http3: false, proxyUrl, timeout: 20000 });
161        try {
162            const sessions = await loginAll(imp, credentials, proxyUrl);
163            sessionCookie = sessions[0];
164            log.info(`[AUTH] signed in${includeOfficers ? ' - directors and officers will be included' : ''}`);
165        } catch (e) {
166            log.warning(`[AUTH] sign-in failed: ${(e as Error).message.slice(0, 100)} - continuing without login-only fields`);
167        } finally {
168            try { (imp as any).close?.(); } catch {}
169        }
170    }
171
172    // Called when a signed-in request gets 429. Workers that hit the limit at
173    // the same time share one switch; a worker holding an older cookie just
174    // picks up whatever the switch produced.
175    let switching: Promise<void> | undefined;
176    let sessionSwitches = 0;
177    const onSessionLimited = async (cookieUsed: string): Promise<void> => {
178        if (switching) return switching;
179        if (sessionCookie !== cookieUsed) return;
180        switching = (async () => {
181            sessionCookie = undefined;
182            sessionSwitches++;
183            if (usePool && await signInFromPool()) {
184                log.info('[AUTH] enrichment account reached its limit - switched to another one');
185            } else {
186                log.warning('[AUTH] officer enrichment limit reached for now - the remaining companies come without officers (not charged)');
187            }
188        })().finally(() => { switching = undefined; });
189        return switching;
190    };
191
192    // Connections are reused (about half the time per page of a new one) and
193    // replaced after MAX_CONNECTION_USES requests, on any failure, or when the
194    // proxy URL changes (e.g. a switch to the backup proxy).
195    interface Client { imp: Impit; proxyUrl?: string; uses: number }
196    const idleClients: Client[] = [];
197    const closeClient = (c: Client) => { try { (c.imp as any).close?.(); } catch {} };
198    const acquireClient = async (): Promise<Client> => {
199        const proxyUrl = await nextProxyUrl();
200        for (let c = idleClients.pop(); c; c = idleClients.pop()) {
201            if (c.proxyUrl === proxyUrl) return c;
202            closeClient(c);
203        }
204        return { imp: new Impit({ browser: 'chrome', http3: false, proxyUrl, timeout: 30000 }), proxyUrl, uses: 0 };
205    };
206    const releaseClient = (c: Client, healthy: boolean) => {
207        c.uses++;
208        if (healthy && c.uses < MAX_CONNECTION_USES) idleClients.push(c);
209        else closeClient(c);
210    };
211
212    let retries = 0;
213    /** GET a page or sitemap shard. Retries blocks, 5xx and network errors on a fresh connection; null on 404/410.
214     *  `signedIn` sends the session cookie; a 429 on a signed-in request switches account instead of retrying it. */
215    const fetchText = async (url: string, accept: string, signedIn = false): Promise<{ text: string; cookie?: string } | null> => {
216        let lastErr: Error | undefined;
217        for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
218            if (switching) await switching;
219            const cookie = signedIn ? sessionCookie : undefined;
220            const client = await acquireClient();
221            let healthy = false;
222            try {
223                const headers: Record<string, string> = { accept };
224                if (cookie) headers.cookie = cookie;
225                const res = await client.imp.fetch(url, { headers });
226                const buf = Buffer.from(await res.arrayBuffer());
227                if (res.status === 404 || res.status === 410) { healthy = true; return null; }
228                if (res.status === 429 && cookie) {
229                    // The account is limited, not the request: switch and retry at once.
230                    healthy = true;
231                    await onSessionLimited(cookie);
232                    attempt--;
233                    continue;
234                }
235                if (res.status >= 400) throw new HttpError(res.status, url);
236                const text = decode(buf);
237                if (isChallenge(text)) throw new HttpError(403, url);
238                healthy = true;
239                return { text, cookie };
240            } catch (e) {
241                lastErr = e as Error;
242                retries++;
243                if (attempt < MAX_ATTEMPTS) await new Promise((r) => setTimeout(r, 500 * attempt + Math.random() * 500));
244            } finally {
245                releaseClient(client, healthy);
246            }
247        }
248        throw lastErr ?? new Error(`failed ${url}`);
249    };
250    const fetchHtml = async (url: string) => fetchText(url, 'text/html,application/xhtml+xml', true);
251
252    if (refreshMode) {
253        const clamp = (v: unknown, def: number, max: number) => Math.max(0, Math.min(max, Number.isFinite(Number(v)) ? Number(v) : def));
254        const limit = clamp(input?.refreshLimit, 500, 5000);
255        const enrichedLimit = clamp(input?.refreshEnrichedLimit, 100, 1000);
256        const purgedPlain = await purgeRecords(RECORD_SOURCE_PLAIN, PURGE_AFTER_DAYS * DAY_MS);
257        const purgedEnriched = await purgeRecords(RECORD_SOURCE_ENRICHED, PURGE_AFTER_DAYS * DAY_MS);
258        log.info(`[REFRESH] deleted ${purgedPlain} plain and ${purgedEnriched} enriched rows not confirmed in ${PURGE_AFTER_DAYS} days`);
259
260        const pick = { minAgeMs: REFRESH_FROM_DAYS * DAY_MS, maxAgeMs: 30 * DAY_MS, minServes: REFRESH_MIN_SERVES, servedWithinMs: 30 * DAY_MS };
261        const plainIds = await listRefreshCandidates(RECORD_SOURCE_PLAIN, { ...pick, limit });
262        const enrichedIds = await listRefreshCandidates(RECORD_SOURCE_ENRICHED, { ...pick, limit: enrichedLimit });
263        log.info(`[REFRESH] ${plainIds.length} plain (limit ${limit}) and ${enrichedIds.length} enriched (limit ${enrichedLimit}) rows to refresh`);
264
265        let refreshed = 0;
266        let gone = 0;
267        let notSignedIn = 0;
268        let refreshFailed = 0;
269        const fresh = new Map<string, { entityId: string; record: unknown }[]>([[RECORD_SOURCE_PLAIN, []], [RECORD_SOURCE_ENRICHED, []]]);
270        const refreshOne = async (entityId: string, source: string): Promise<void> => {
271            const url = `${BASE}/companies/${entityId}`;
272            const enriched = source === RECORD_SOURCE_ENRICHED;
273            try {
274                const page = await fetchText(url, 'text/html,application/xhtml+xml', enriched);
275                if (!page) { gone++; return; }
276                const signedIn = Boolean(page.cookie) && !page.text.includes('href="/users/sign_in" rel="nofollow"');
277                // Never overwrite an enriched row with signed-out data; it stays until it expires.
278                if (enriched && !signedIn) { notSignedIn++; return; }
279                const d = parseCompanyDetails(loadHtml(page.text), enriched, url);
280                if (!d.name || !d.companyNumber) { gone++; return; }
281                fresh.get(source)!.push({ entityId, record: { ...d, url, scrapedAt: new Date().toISOString() } });
282                refreshed++;
283            } catch {
284                refreshFailed++;
285            }
286        };
287        await runWithGlobalSlidingWindow(plainIds, maxConcurrency, async (id) => refreshOne(id, RECORD_SOURCE_PLAIN));
288        if (enrichedIds.length) {
289            usePool = true;
290            if (await signInFromPool()) {
291                await runWithGlobalSlidingWindow(enrichedIds, Math.min(maxConcurrency, 5), async (id) => refreshOne(id, RECORD_SOURCE_ENRICHED));
292            } else {
293                log.warning('[REFRESH] sign-in unavailable - enriched rows left as they are');
294            }
295        }
296        for (const [source, rows] of fresh) {
297            for (let i = 0; i < rows.length; i += 100) await writeRecords(source, rows.slice(i, i + 100), RECORD_SCHEMA);
298        }
299        for (const c of idleClients.splice(0)) closeClient(c);
300        log.info(`[REFRESH] refreshed ${refreshed}, gone ${gone}, not signed in ${notSignedIn}, failed ${refreshFailed}, written ${recordCounters.writes}`);
301        await finishRunTelemetry('succeeded', {
302            rows: 0,
303            refreshMode: true,
304            purgedPlain,
305            purgedEnriched,
306            refreshCandidates: plainIds.length + enrichedIds.length,
307            refreshed,
308            refreshGone: gone,
309            refreshFailed,
310            recordWrites: recordCounters.writes,
311            recordErrors: recordCounters.errors,
312        });
313        await Actor.exit();
314    }
315
316    // 1. Build the detail-URL work list.
317    const detailUrls: string[] = [...startUrls];
318    const seen = new Set<string>(startUrls);
319
320    if (jurisdictions.length) {
321        log.info(`[DISCOVER] finding companies in: ${jurisdictions.join(', ')}`);
322        // The sitemap index lists ~5700 shards of 40,000 company URLs each (gzipped),
323        // grouped loosely by jurisdiction.
324        const idxHtml = (await fetchText(`${BASE}/sitemap.xml.gz`, '*/*'))?.text;
325        if (!idxHtml) throw new Error('The OpenCorporates company index is unavailable right now - try again later or use startUrls.');
326        const $idx = loadHtml(idxHtml, { xml: true });
327        const shardUrls: string[] = [];
328        $idx('loc').each((_, el) => {
329            const u = $idx(el).text().trim();
330            if (u.includes('/sitemap/sitemap')) shardUrls.push(u);
331        });
332        const total = shardUrls.length;
333        const shardByNumber = new Map<number, string>();
334        for (const u of shardUrls) {
335            const n = Number(u.match(/sitemap(\d+)\.xml/)?.[1]);
336            if (n) shardByNumber.set(n, u);
337        }
338
339        // Which requested jurisdiction a company URL belongs to ("us" also takes "us_ca").
340        const bucketOf = (jur: string): string | undefined =>
341            jurisdictions.find((j) => j === jur) ?? jurisdictions.find((j) => j === jur.split('_')[0]);
342        const buckets = new Map<string, string[]>(jurisdictions.map((j) => [j, []]));
343        // Companies wanted per jurisdiction: the skipped ones plus some spare for removed pages.
344        const target = Math.max(50, Math.ceil((startOffset + maxItems * 1.5) / jurisdictions.length));
345        const short = () => jurisdictions.filter((j) => buckets.get(j)!.length < target);
346
347        const readShards = new Set<string>();
348        const readShard = async (shardUrl: string): Promise<void> => {
349            readShards.add(shardUrl);
350            try {
351                const text = (await fetchText(shardUrl, '*/*'))?.text;
352                if (!text) return;
353                const $s = loadHtml(text, { xml: true });
354                $s('loc').each((_, el) => {
355                    const u = $s(el).text().trim();
356                    const m = u.match(/\/companies\/([a-z]{2}(?:_[a-z0-9]{2,3})?)\//);
357                    const bucket = m && bucketOf(m[1]);
358                    if (!bucket) return;
359                    const url = normalizeCompanyUrl(u);
360                    if (url && !seen.has(url)) { seen.add(url); buckets.get(bucket)!.push(url); }
361                });
362            } catch (e) {
363                log.warning(`[DISCOVER] one company list could not be loaded: ${(e as Error).message.slice(0, 80)}`);
364            }
365        };
366
367        // Per jurisdiction: the shards known to hold it, then their unsampled
368        // neighbours. Read them round-robin so every jurisdiction gets its share.
369        const queues = new Map<string, string[]>();
370        for (const j of jurisdictions) {
371            const hinted = Object.entries(SHARD_HINTS)
372                .filter(([code]) => code === j || code.startsWith(`${j}_`))
373                .flatMap(([, shards]) => shards);
374            const q: string[] = [];
375            const add = (u: string | undefined) => { if (u && !q.includes(u)) q.push(u); };
376            for (const n of hinted) add(shardByNumber.get(n));
377            for (const n of hinted) for (let d = 1; d < 14; d++) add(shardByNumber.get(n + d));
378            queues.set(j, q);
379        }
380        for (let pending = short(); pending.length; pending = short()) {
381            const ready = pending.filter((j) => queues.get(j)!.some((u) => !readShards.has(u)));
382            if (!ready.length) break;
383            for (const j of ready) {
384                const next = queues.get(j)!.find((u) => !readShards.has(u));
385                if (next) await readShard(next);
386            }
387        }
388
389        // Anything still short: stride across the whole index, stopping after a
390        // long run of shards with nothing new.
391        if (short().length) {
392            const stride = Math.max(1, Math.floor(total / 400));
393            let emptyInARow = 0;
394            for (let i = 0; i < total && short().length; i += stride) {
395                if (readShards.has(shardUrls[i])) continue;
396                if (emptyInARow >= 40) {
397                    log.warning('[DISCOVER] no more companies found for these jurisdictions - continuing with what was found');
398                    break;
399                }
400                const before = seen.size;
401                await readShard(shardUrls[i]);
402                emptyInARow = seen.size > before ? 0 : emptyInARow + 1;
403            }
404        }
405
406        // Interleave so maxItems is shared across jurisdictions.
407        const lists = jurisdictions.map((j) => buckets.get(j)!);
408        const discovered: string[] = [];
409        for (let i = 0; lists.some((l) => i < l.length); i++) {
410            for (const l of lists) if (i < l.length) discovered.push(l[i]);
411        }
412        log.info(`[DISCOVER] found ${jurisdictions.map((j) => `${buckets.get(j)!.length} in ${j}`).join(', ')}`);
413        // startOffset continues where an earlier run stopped; it applies to discovered companies only.
414        if (startOffset) {
415            if (startOffset >= discovered.length) log.warning(`[DISCOVER] startOffset ${startOffset} is past the ${discovered.length} companies found`);
416            else log.info(`[DISCOVER] skipping the first ${startOffset} companies (startOffset)`);
417        }
418        detailUrls.push(...discovered.slice(startOffset));
419        log.debug(`[DISCOVER] lists read: ${readShards.size}`);
420    }
421
422    if (!detailUrls.length) {
423        const known = Object.keys(SHARD_HINTS).filter((k) => !k.includes('_')).join(', ');
424        throw new Error(`No companies found for ${jurisdictions.join(', ') || 'the input'}. Check the jurisdiction codes (known countries: ${known}) or provide company URLs.`);
425    }
426
427    // 2. Rows: recent ones from the record store, the rest fetched and parsed live.
428    // `reserved` counts rows that are committed to being pushed, so parallel
429    // workers can never push more than maxItems (each row is a billed event).
430    let reserved = 0;
431    let pushed = 0;
432    let failed = 0;
433    let skipped = 0;
434    let sessionWarned = false;
435    let enrichedRows = 0;
436    let fromStore = 0;
437    let fetchedLive = 0;
438    const pushedKeys = new Set<string>();
439
440    /** Push one row; enrichment is charged when the row carries signed-in data. */
441    const pushRow = async (row: Record<string, any>, enriched: boolean): Promise<boolean> => {
442        const key = `${row.jurisdictionCode}|${row.companyNumber}`;
443        if (pushedKeys.has(key) || reserved >= maxItems) return false;
444        pushedKeys.add(key);
445        reserved++;
446        await Dataset.pushData(row);
447        if (enriched) {
448            enrichedRows++;
449            try { await Actor.charge({ eventName: 'officer-enrichment' }); } catch { /* event not priced (local run) */ }
450        }
451        pushed++;
452        if (pushed % 100 === 0) log.info(`[PROGRESS] ${pushed}/${maxItems} companies`);
453        return true;
454    };
455
456    // Ids handed out this window, per source, for markServed (after the window's writes).
457    const served = new Map<string, string[]>([[RECORD_SOURCE_PLAIN, []], [RECORD_SOURCE_ENRICHED, []]]);
458    const pendingWrites = new Map<string, { entityId: string; record: unknown }[]>([[RECORD_SOURCE_PLAIN, []], [RECORD_SOURCE_ENRICHED, []]]);
459    const flushWrites = async (): Promise<void> => {
460        for (const [source, rows] of pendingWrites) {
461            if (!rows.length) continue;
462            await writeRecords(source, rows.splice(0), RECORD_SCHEMA);
463        }
464    };
465
466    const fetchLive = async (url: string): Promise<void> => {
467        if (reserved >= maxItems) return;
468        try {
469            const page = await fetchHtml(url);
470            if (!page) {
471                skipped++;
472                log.info(`[DETAIL] ${url} no longer exists - skipped`);
473                return;
474            }
475            const html = page.text;
476            const signedOutPage = html.includes('href="/users/sign_in" rel="nofollow"');
477            if (page.cookie && signedOutPage && !sessionWarned) {
478                sessionWarned = true;
479                log.warning('[AUTH] OpenCorporates treats this run as signed out (session expired?) - login-only fields will be empty');
480            }
481            // Charge enrichment only for rows whose page was actually loaded signed in.
482            const enriched = enrichmentOn && Boolean(page.cookie) && !signedOutPage;
483            const d = parseCompanyDetails(loadHtml(html), includeOfficers, url);
484            if (!d.name || !d.companyNumber) {
485                skipped++;
486                log.warning(`[DETAIL] ${url} has no company record - skipped`);
487                return;
488            }
489            const row = { ...d, url, scrapedAt: new Date().toISOString() };
490            // Stored whatever this run needs: the row is just as valid for the next one.
491            // Signed-in rows parsed without officers are not stored as enriched.
492            const signedIn = Boolean(page.cookie) && !signedOutPage;
493            const storeAs = !signedIn ? RECORD_SOURCE_PLAIN : includeOfficers ? RECORD_SOURCE_ENRICHED : undefined;
494            if (storeAs) pendingWrites.get(storeAs)!.push({ entityId: entityIdOf(url), record: row });
495            if (await pushRow(row, enriched)) {
496                fetchedLive++;
497                if (storeAs) served.get(storeAs)!.push(entityIdOf(url));
498            }
499        } catch (e) {
500            failed++;
501            log.warning(`[WORKER] ${url}: ${(e as Error).message.slice(0, 120)}`);
502        }
503    };
504
505    // Work in windows: one batch lookup per window, stored rows go out at once,
506    // the rest are fetched in parallel. Stored rows are written back per window.
507    const readSource = includeOfficers ? RECORD_SOURCE_ENRICHED : RECORD_SOURCE_PLAIN;
508    const window = Math.max(200, maxConcurrency * 20);
509    for (let i = 0; i < detailUrls.length && reserved < maxItems; i += window) {
510        const urls = detailUrls.slice(i, i + window);
511        const stored = recordMaxAgeDays > 0
512            ? await readRecords<Record<string, any>>(readSource, urls.map(entityIdOf), RECORD_SCHEMA, recordMaxAgeDays * DAY_MS)
513            : new Map();
514        const live: string[] = [];
515        const hits: Record<string, any>[] = [];
516        for (const url of urls) {
517            const hit = stored.get(entityIdOf(url));
518            if (!hit) { live.push(url); continue; }
519            const key = `${hit.record.jurisdictionCode}|${hit.record.companyNumber}`;
520            if (pushedKeys.has(key) || reserved >= maxItems) continue;
521            pushedKeys.add(key);
522            reserved++;
523            hits.push(hit.record);
524            served.get(readSource)!.push(entityIdOf(url));
525        }
526        if (hits.length) {
527            // One push for the whole batch: stored rows need no fetching, only writing out.
528            await Dataset.pushData(hits);
529            if (readSource === RECORD_SOURCE_ENRICHED) {
530                enrichedRows += hits.length;
531                try { await Actor.charge({ eventName: 'officer-enrichment', count: hits.length }); } catch { /* event not priced (local run) */ }
532            }
533            const before = pushed;
534            pushed += hits.length;
535            fromStore += hits.length;
536            if (Math.floor(pushed / 100) > Math.floor(before / 100)) log.info(`[PROGRESS] ${pushed}/${maxItems} companies`);
537        }
538        await runWithGlobalSlidingWindow(live, maxConcurrency, fetchLive);
539        await flushWrites();
540        for (const [source, ids] of served) if (ids.length) await markServed(source, ids.splice(0));
541    }
542    for (const c of idleClients.splice(0)) closeClient(c);
543
544    if (fromStore) log.info(`[DONE] ${fromStore} compan${fromStore === 1 ? 'y' : 'ies'} from results collected in the last ${recordMaxAgeDays} days, ${fetchedLive} loaded fresh`);
545    log.info(`[DONE] ${retries} request(s) retried`);
546    if (enrichmentOn) log.info(`[DONE] ${enrichedRows} row(s) enriched with officer data${sessionSwitches ? `, ${sessionSwitches} account switch(es)` : ''}`);
547    if (failed) log.warning(`[DONE] ${failed} company page(s) could not be loaded after ${MAX_ATTEMPTS} attempts`);
548    if (skipped) log.info(`[DONE] ${skipped} page(s) skipped (removed or empty)`);
549    if (!pushed && failed) throw new Error(`No company could be loaded (${failed} failures) - try again later.`);
550    log.info(`[DONE] pushed ${pushed} company rows`);
551    await finishRunTelemetry('succeeded', {
552        rows: pushed,
553        recordHits: recordCounters.hits,
554        recordMisses: recordCounters.misses,
555        recordStale: recordCounters.stale,
556        recordWrites: recordCounters.writes,
557        recordErrors: recordCounters.errors,
558    });
559} catch (err) {
560    console.error('[FATAL]', err);
561    await finishRunTelemetry('failed', { error: String(err) }).catch(() => {});
562    throw err;
563}
564
565await Actor.exit();

test/parser.test.ts

1import assert from 'node:assert/strict';
2import { readFileSync } from 'node:fs';
3import { test } from 'node:test';
4
5import { load } from 'cheerio';
6
7import { isChallenge, normalizeCompanyUrl, parseCompanyDetails } from '../src/lib/parser.js';
8
9const fixture = (name: string) => load(readFileSync(new URL(`./fixtures/${name}.html`, import.meta.url), 'utf8'));
10
11test('GB page: address lines separated, login placeholders dropped, counts kept', () => {
12    const d = parseCompanyDetails(fixture('gb_05957738'), true, 'https://opencorporates.com/companies/gb/05957738');
13    assert.equal(d.name, 'LIBRA INVESTMENT PROPERTY GROUP LIMITED');
14    assert.equal(d.companyNumber, '05957738');
15    assert.equal(d.status, 'Active');
16    assert.equal(d.jurisdictionCode, 'gb');
17    assert.equal(d.incorporationDate, null);
18    assert.equal(d.registeredAddress, 'Penycastell Farm, Bryn, Port Talbot, SA13 2PY, West Glamorgan, United Kingdom');
19    assert.equal(d.industryCodes.length, 3);
20    assert.deepEqual(d.previousNames, ['£IBRA FINANCIAL SERVICES LIMITED']);
21    assert.equal(d.latestAccountsDate, '2025-03-31');
22    assert.equal(d.officersCount, 2);
23    assert.equal(d.inactiveOfficersCount, 3);
24    assert.equal(d.beneficialOwnersCount, 3);
25    assert.ok(d.loginRequiredFields.includes('incorporationDate'));
26    assert.ok(d.loginRequiredFields.includes('dataSource'));
27    assert.equal(d.dataSource, null);
28    assert.ok(!JSON.stringify(d).toLowerCase().includes('please log in'));
29});
30
31test('US-CA page: identifiers, agent and filings', () => {
32    const d = parseCompanyDetails(fixture('us_ca_C0806592'), true, 'https://opencorporates.com/companies/us_ca/C0806592');
33    assert.equal(d.name, 'APPLE INC.');
34    assert.equal(d.agentName, 'C T CORPORATION SYSTEM');
35    assert.deepEqual(d.previousCompanyNumbers, ['C0806592']);
36    assert.deepEqual(d.otherIdentifiers.find((i) => i.type === 'US EIN number'), { type: 'US EIN number', value: '942404110' });
37    assert.ok(d.recentFilings.length > 0);
38    assert.match(d.recentFilings[0].url ?? '', /^https:\/\/opencorporates\.com\/filings\/\d+$/);
39    assert.equal(d.officersCount, 25);
40});
41
42test('sparse ES page and NL page with extra attribute', () => {
43    const es = parseCompanyDetails(fixture('es_80331051'), true);
44    assert.equal(es.companyType, 'Sociedad Limitada');
45    assert.equal(es.status, null);
46    assert.equal(es.registeredAddress, null);
47
48    const nl = parseCompanyDetails(fixture('nl_17087985'), true);
49    assert.equal(nl.registeredAddress, 'Ceresstraat 13, Breda, 4811CA, Netherlands');
50    assert.match(nl.otherAttributes.restricted, /Non Mailing Indicator/);
51});
52
53test('logged-in GB page: officers with dates, corporate flag, owners, source', () => {
54    const d = parseCompanyDetails(fixture('auth_gb'), true, 'https://opencorporates.com/companies/gb/05957738');
55    assert.equal(d.incorporationDate, '2006-10-05');
56    assert.deepEqual(d.beneficialOwners, ['Mr David Ian Bromley', 'Mr David Ian Bromley-Cornfield', 'Mrs Elizabeth Davies']);
57    assert.equal(d.directorsOfficers.filter((o) => o.isActive).length, 2);
58    assert.equal(d.officersCount, 2);
59    assert.equal(d.inactiveOfficersCount, 3);
60    const first = d.directorsOfficers[0];
61    assert.deepEqual(
62        { name: first.name, position: first.position, startDate: first.startDate, endDate: first.endDate },
63        { name: 'DAVID IAN BROMLEY-CORNFIELD', position: 'director', startDate: '1 Oct 2010', endDate: null },
64    );
65    const phoenix = d.directorsOfficers.find((o) => o.name === 'PHOENIX AUDIT LIMITED');
66    assert.ok(phoenix && phoenix.isCorporate && !phoenix.isActive && phoenix.position === 'secretary' && phoenix.endDate === '5 Oct 2009');
67    assert.equal(d.dataSource?.name, 'UK Companies House');
68    assert.equal(d.registryPage, 'https://beta.companieshouse.gov.uk/company/05957738');
69    assert.deepEqual(d.loginRequiredFields, []);
70});
71
72test('logged-in US-CA page: inactive officers without dates', () => {
73    const d = parseCompanyDetails(fixture('auth_us_ca'), true);
74    assert.equal(d.incorporationDate, '1977-01-03');
75    assert.equal(d.directorsOfficers.length, 25 + 29);
76    assert.ok(d.directorsOfficers.some((o) => o.name === 'Arthur D. Levinson' && o.position === 'director' && !o.isActive));
77    assert.equal(d.dataSource?.name, 'California Secretary of State');
78});
79
80test('includeOfficers=false leaves the list empty', () => {
81    assert.deepEqual(parseCompanyDetails(fixture('auth_gb'), false).directorsOfficers, []);
82});
83
84test('normalizeCompanyUrl', () => {
85    assert.equal(normalizeCompanyUrl('opencorporates.com/companies/GB/05957738/'), 'https://opencorporates.com/companies/gb/05957738');
86    assert.equal(normalizeCompanyUrl('https://opencorporates.com/companies/us_ca/0806592?x=1#a'), 'https://opencorporates.com/companies/us_ca/0806592');
87    assert.equal(normalizeCompanyUrl('http://www.opencorporates.com/companies/ca_bc/BC123'), 'https://opencorporates.com/companies/ca_bc/BC123');
88    assert.equal(normalizeCompanyUrl('https://opencorporates.com/officers/123'), null);
89    assert.equal(normalizeCompanyUrl('https://example.com/companies/gb/1'), null);
90});
91
92test('isChallenge leaves real pages alone', () => {
93    assert.equal(isChallenge(readFileSync(new URL('./fixtures/gb_05957738.html', import.meta.url), 'utf8')), false);
94    assert.equal(isChallenge('<title>Checking your browser - reCAPTCHA</title>'), true);
95});

src/types/inputs.ts

1export interface Credential {
2    username: string;
3    password: string;
4}
5
6export interface Input {
7    jurisdictions?: string[];
8    startUrls?: (string | { url: string })[];
9    loginEmail?: string;
10    loginPassword?: string;
11    /** Legacy: [{username, password}] pairs. loginEmail/loginPassword replace it. */
12    credentials?: Credential[];
13    includeOfficers?: boolean;
14    maxItems?: number;
15    /** Skip this many discovered companies, to continue where an earlier run stopped. */
16    startOffset?: number;
17    maxConcurrency?: number;
18    /** Serve companies collected within this many days from the record store; 0 = always fetch fresh. */
19    recordMaxAgeDays?: number;
20    /** Owner-only maintenance run (not in the input schema): purge old rows, refresh popular ones. */
21    refreshStore?: boolean;
22    refreshLimit?: number;
23    refreshEnrichedLimit?: number;
24    proxy?: object;
25    debugForceProxyFallback?: boolean;
26}

src/lib/auth.ts

1/**
2 * OpenCorporates authenticated session.
3 *
4 * Login flow (simplified — the old KEY-cookie JS trick is dead, replaced by
5 * reCAPTCHA Enterprise WAF on the search path, but the login POST itself
6 * still works):
7 *   1. GET /users/sign_in — pull the authenticity_token from the hidden input
8 *      and the _openc_session cookie from set-cookie.
9 *   2. POST /users/sign_in with email/password + authenticity_token. A 302
10 *      means success (authenticated session); a 200 means the form re-rendered
11 *      (bad credentials or challenge). The _openc_session cookie from a 302
12 *      response is the authenticated session.
13 *   3. Sessions last ~24h. We cache them in the Apify KV store keyed by
14 *      username so repeat runs skip the login.
15 */
16import { Impit } from 'impit';
17import { load as loadHtml } from 'cheerio';
18import { KeyValueStore, log } from 'apify';
19import type { Credential } from '../types/inputs.js';
20
21const BASE = 'https://opencorporates.com';
22const SESSION_TTL_MS = 23 * 60 * 60 * 1000; // 23h, under opencorporates' 24h expiry
23
24const BROWSER_HEADERS = {
25    'accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7',
26    'accept-language': 'en-US,en;q=0.9',
27    'sec-ch-ua': '"Chromium";v="130", "Google Chrome";v="130", "Not?A_Brand";v="99"',
28    'sec-ch-ua-mobile': '?0',
29    'sec-ch-ua-platform': '"macOS"',
30    'sec-fetch-dest': 'document',
31    'sec-fetch-mode': 'navigate',
32    'sec-fetch-site': 'same-origin',
33    'upgrade-insecure-requests': '1',
34    'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36',
35} as const;
36
37function extractOpencSession(setCookie: string[]): string | null {
38    for (const c of setCookie) {
39        if (c.includes('_openc_session=')) {
40            return c.split(';')[0].trim();
41        }
42    }
43    return null;
44}
45
46async function kv(): Promise<KeyValueStore> {
47    return KeyValueStore.open('opencorporates-sessions');
48}
49
50// KV keys only allow [a-zA-Z0-9!-_.'()] - sanitize aggressively
51const sessionKey = (username: string) => `session-${username.replace(/[^a-zA-Z0-9_-]/g, '_')}`;
52
53/**
54 * Get a cached, non-expired session for a username, or null. The cache is a
55 * convenience: a run whose token cannot open the named store just signs in.
56 */
57export async function getCachedSession(username: string): Promise<string | null> {
58    try {
59        const store = await kv();
60        const rec = (await store.getValue(sessionKey(username))) as { opencSession: string; expiresAt: number } | null;
61        if (!rec?.opencSession) return null;
62        if (Date.now() > rec.expiresAt) return null;
63        log.debug('[AUTH] reusing the session from an earlier run');
64        return rec.opencSession;
65    } catch (e) {
66        log.debug(`[AUTH] session cache unavailable: ${(e as Error).message.slice(0, 100)}`);
67        return null;
68    }
69}
70
71async function cacheSession(username: string, opencSession: string): Promise<void> {
72    try {
73        const store = await kv();
74        await store.setValue(sessionKey(username), {
75            opencSession,
76            createdAt: Date.now(),
77            expiresAt: Date.now() + SESSION_TTL_MS,
78        });
79    } catch (e) {
80        log.debug(`[AUTH] could not cache the session: ${(e as Error).message.slice(0, 100)}`);
81    }
82}
83
84/** Log in once and return the `_openc_session=...` cookie string. */
85export async function login(impit: Impit, cred: Credential, proxyUrl?: string): Promise<string> {
86    const cached = await getCachedSession(cred.username);
87    if (cached) return cached;
88
89    const imp = proxyUrl
90        ? new Impit({ browser: 'chrome', http3: false, proxyUrl })
91        : impit;
92
93    // 1. GET the login page for the authenticity_token + session cookie.
94    const loginPageRes = await imp.fetch(`${BASE}/users/sign_in`, { headers: BROWSER_HEADERS });
95    const loginHtml = await loginPageRes.text();
96    const $ = loadHtml(loginHtml);
97    const authenticityToken = $('input[name="authenticity_token"][type="hidden"]').val();
98    if (!authenticityToken) {
99        throw new Error(`[AUTH] no authenticity_token on login page for ${cred.username}`);
100    }
101
102    const setCookies = (loginPageRes.headers.getSetCookie?.() ?? []) as string[];
103    const sessionCookies = setCookies.map((c: string) => c.split(';')[0]).join('; ');
104
105    // 2. POST the login form.
106    const body = new URLSearchParams({
107        utf8: '✓',
108        authenticity_token: String(authenticityToken),
109        'user[email]': cred.username,
110        'user[password]': cred.password,
111        'user[remember_me]': 'on',
112        redirect_to: '',
113        submit: '',
114    }).toString();
115
116    const postRes = await imp.fetch(`${BASE}/users/sign_in`, {
117        method: 'POST',
118        headers: {
119            ...BROWSER_HEADERS,
120            'content-type': 'application/x-www-form-urlencoded',
121            Referer: `${BASE}/users/sign_in`,
122            cookie: sessionCookies,
123        },
124        body,
125        redirect: 'manual',
126    });
127
128    // 302 = success (impit does not follow when redirect: manual). 200 = form
129    // re-rendered = bad credentials or reCAPTCHA challenge.
130    if (postRes.status === 200) {
131        throw new Error(`[AUTH] sign-in failed for ${cred.username} (wrong email/password, or OpenCorporates asked for extra verification)`);
132    }
133
134    const postSetCookies = (postRes.headers.getSetCookie?.() ?? []) as string[];
135    const opencSession = extractOpencSession(postSetCookies);
136    if (!opencSession) {
137        throw new Error(`[AUTH] no _openc_session in login response for ${cred.username}`);
138    }
139
140    await cacheSession(cred.username, opencSession);
141    log.info('[AUTH] signed in');
142    return opencSession;
143}
144
145/** Log in with each credential, return all valid session cookie strings. */
146export async function loginAll(impit: Impit, credentials: Credential[], proxyUrl?: string): Promise<string[]> {
147    const sessions: string[] = [];
148    for (const cred of credentials) {
149        try {
150            const s = await login(impit, cred, proxyUrl);
151            sessions.push(s);
152        } catch (e) {
153            log.error(`[AUTH] ${cred.username}: ${(e as Error).message}`);
154        }
155    }
156    if (!sessions.length) {
157        throw new Error('[AUTH] no valid sessions — check credentials');
158    }
159    return sessions;
160}
161
162/** Operator-owned OpenCorporates accounts used for officer enrichment.
163 *  Sessions are cached in KV per username (23h), so once every account has
164 *  been warmed the pool rotates across cached sessions without re-logging. */
165const BUILTIN_ACCOUNTS: Credential[] = [
166    { username: 'memo23@yopmail.com', password: 'memo23' },
167    { username: 'memo12@yopmail.com', password: '3/vt42a882nf$Pd' },
168    { username: 'memo34@yopmail.com', password: '3/vt42a882nf$Pd' },
169    { username: 'memo45@yopmail.com', password: '3/vt42a882nf$Pd' },
170    { username: 'memo56@yopmail.com', password: '3/vt42a882nf$Pd' },
171    { username: 'memo67@yopmail.com', password: '3/vt42a882nf$Pd' },
172    { username: 'memo78@yopmail.com', password: '3/vt42a882nf$Pd' },
173    { username: 'irma78@yopmail.com', password: '3/vt42a882nf$Pd' },
174    { username: 'webtester83@yopmail.com', password: 'X8zwhKQaPE3WYV@' },
175    { username: 'webcodus@yopmail.com', password: 'ZaK!fG7jDL6x.gZ' },
176    { username: 'leads@yopmail.com', password: 'Sr36HTXZ4u-!@T$' },
177    { username: 'a18106051329@yopmail.com', password: '3/vt42a882nf$Pd' },
178];
179
180export interface PoolSession {
181    username: string;
182    cookie: string;
183}
184
185/** Log in with the operator-owned account pool. Tries accounts not in `tried`
186 *  in random order (spread across the pool) and returns the first session that
187 *  works, or null once every account has been tried. Each account it attempts
188 *  is added to `tried`. Never throws: the caller falls back to anonymous mode. */
189export async function loginBuiltin(impit: Impit, proxyUrl: string | undefined, tried: Set<string>): Promise<PoolSession | null> {
190    const shuffled = BUILTIN_ACCOUNTS.filter((c) => !tried.has(c.username)).sort(() => Math.random() - 0.5);
191    for (const cred of shuffled) {
192        tried.add(cred.username);
193        try {
194            return { username: cred.username, cookie: await login(impit, cred, proxyUrl) };
195        } catch (e) {
196            log.debug?.(`[AUTH] ${cred.username}: ${(e as Error).message.slice(0, 80)}`);
197        }
198    }
199    return null;
200}

src/lib/concurrency.ts

1/**
2 * Global sliding-window concurrency helpers — see IMPROVMENT-CONSOLIDATED.md §7.
3 *
4 * These deliberately avoid the "await Promise.all of one batch then start the next"
5 * anti-pattern; instead a single Set<Promise> caps in-flight work globally so
6 * stragglers in batch N never starve workers that could be doing batch N+1.
7 */
8
9/**
10 * Process a fixed list of items with a global cap on concurrent fn(item) calls.
11 * Returns results in the original index order. Errors propagate out and abort
12 * the producer loop — wrap fn yourself if you need per-item error tolerance.
13 */
14export async function runWithGlobalSlidingWindow<T, R>(
15    items: T[],
16    limit: number,
17    fn: (item: T, index: number) => Promise<R>,
18): Promise<R[]> {
19    const results: R[] = new Array(items.length);
20    const inFlight = new Set<Promise<void>>();
21
22    for (let idx = 0; idx < items.length; idx++) {
23        const item = items[idx];
24        const i = idx;
25        let p!: Promise<void>;
26        p = (async () => {
27            results[i] = await fn(item, i);
28        })().finally(() => inFlight.delete(p));
29        inFlight.add(p);
30        if (inFlight.size >= limit) {
31            await Promise.race(inFlight);
32        }
33    }
34    await Promise.all(inFlight);
35    return results;
36}
37
38/**
39 * Paginated producer + consumer with a single global sliding window.
40 *
41 * fetchPage(n) returns the items on page n + a `hasNext` flag.
42 * processItem runs concurrently up to maxConcurrent across all pages.
43 * Stops when fetchPage reports !hasNext OR maxItems is reached.
44 */
45export async function runPaginatedWithSlidingWindow<TItem, TResult>(opts: {
46    fetchPage: (page: number) => Promise<{ items: TItem[]; hasNext: boolean }>;
47    processItem: (item: TItem) => Promise<TResult>;
48    maxConcurrent: number;
49    maxItems?: number;
50    onProcessed?: (result: TResult, item: TItem) => void;
51}): Promise<void> {
52    const { fetchPage, processItem, maxConcurrent, maxItems, onProcessed } = opts;
53    const inFlight = new Set<Promise<void>>();
54    let processed = 0;
55    let page = 1;
56
57    while (true) {
58        const { items, hasNext } = await fetchPage(page);
59
60        for (const item of items) {
61            if (typeof maxItems === 'number' && processed >= maxItems) break;
62            processed++;
63            let p!: Promise<void>;
64            p = (async () => {
65                const r = await processItem(item);
66                onProcessed?.(r, item);
67            })().finally(() => inFlight.delete(p));
68            inFlight.add(p);
69            if (inFlight.size >= maxConcurrent) {
70                await Promise.race(inFlight);
71            }
72        }
73
74        if (!hasNext) break;
75        if (typeof maxItems === 'number' && processed >= maxItems) break;
76        page++;
77    }
78    await Promise.all(inFlight);
79}
80
81/** Returns the first promise that resolves; rejects only when ALL fail (clutch-style). */
82export async function firstSuccess<T>(promises: Array<Promise<T>>): Promise<T> {
83    return new Promise((resolve, reject) => {
84        const errors: unknown[] = [];
85        let settled = 0;
86        const check = () => {
87            if (settled === promises.length) {
88                reject(Object.assign(new Error('All parallel fetches failed'), { errors }));
89            }
90        };
91        promises.forEach((p) =>
92            p.then(resolve).catch((e) => {
93                errors.push(e);
94                settled++;
95                check();
96            }),
97        );
98    });
99}
100
101/** Promise-wrapped sleep. */
102export const sleep = (ms: number) => new Promise<void>((res) => setTimeout(res, ms));

src/lib/failureAlertWebhook.ts

1import { createHmac } from 'node:crypto';
2import { Actor } from 'apify';
3
4/**
5 * Instant per-actor failure/abort alert, posted to the Telegram channel by the alert relay
6 * (shared-telegram/relay, on Fly.io).
7 *
8 * Apify platform-side webhook: fires from Apify's backend when the run terminates
9 * as FAILED / ABORTED / TIMED_OUT, so it survives OOM / SIGKILL / hard-timeout
10 * where no in-actor code could run, and it also fires for CUSTOMER runs in their
11 * own accounts. ONLY failure terminations alert — never SUCCEEDED.
12 *
13 * The webhook lives in the account that owns the run, so the customer can read it. It must
14 * hold NO secret: no bot token, no chat id, no API key. Until 2026-10-27 its URL held the bot
15 * token; now it is the relay's /v1/run-event URL with the run id and an HMAC of it (see
16 * RUN_EVENT_KEY), and the relay holds the bot token and chat id as Fly secrets.
17 *
18 * The run's INPUT is embedded at REGISTRATION time (startup), NOT pulled at fire
19 * time — the platform webhook can't read the KV store, and on a timeout/OOM kill
20 * nothing in-process runs to fetch it. Baking it in means the alert carries the
21 * input for retry even on a hard kill. Secrets are redacted first.
22 *
23 * CANONICAL COPY: /Users/muhameddidovic/projects/shared-failure-alerts. Edit it there and
24 * run sync-failure-alerts.sh; a fix made inside one actor never reaches the others.
25 *
26 * Defaults below = the memo23 "Apify Alerts" channel. Pass a different chat by
27 * editing ALERT_CHAT, or point ALERT_BOT at a different bot.
28 */
29export const ALERT_BOT = '8618311850:AAFbsEJX-fVZMUWXYa2MaRF5-hWgJ--uUwQ';
30export const ALERT_CHAT = '-1003506227793'; // "Apify Alerts" channel
31
32/**
33 * The Telegram alert relay (shared-telegram/relay, on Fly.io). Every run registers its own
34 * webhook, so a farm of failing runs on one actor would send this bot one alert per run and
35 * could get it blocked for hours, silencing ~390 actors at once: one actor's 75k failed runs
36 * did exactly that to the lifecycle bot on 2026-10-08 (blocked 05:03-16:12 UTC). Aimed
37 * straight at a rate-limited Telegram it is worse, since Apify retries a failed delivery 11
38 * times. The relay keeps one budget per actor across all its runs, folds a flood into a
39 * summary, and always answers Apify with a 2xx.
40 *
41 * The webhook points at the relay only when the relay answers /health at registration;
42 * otherwise straight at Telegram, byte-for-byte as before. A relay that dies after that makes
43 * Apify retry the delivery (1, 2, 4 … min, 11 times over ~32 h): the alert is late, not lost.
44 * Renaming the relay means changing fly.toml there and this constant together.
45 */
46export const ALERT_RELAY_URL = 'https://memo23-tg-relay.fly.dev';
47const RELAY_PROBE_TIMEOUT_MS = 1_500;
48
49/**
50 * The run's failure webhook carries NO secret (2026-10-27). Ad-hoc webhooks live in the account
51 * that owns the run, where the customer can read their URL, headers and payload; until then the
52 * URL held this bot's token. Now it points at the relay's /v1/run-event with the run id, a
53 * channel name and `sig`, an HMAC of the run id under this key. The relay (Fly secret
54 * RUN_EVENT_KEY) checks it and posts with the bot token and chat id it holds itself. A sig is
55 * good for its own run only, and the relay takes each run's alert once.
56 */
57const RUN_EVENT_KEY = '22be5be44be322d0d5971d2276647f05331333223753ff2be51075bf005431c4';
58
59/** hex32 HMAC of the run id; must match runEventSig() in shared-telegram/relay/run-event.mjs. */
60export function runEventSig(runId: string): string {
61    return createHmac('sha256', RUN_EVENT_KEY).update(`run-event:v1:${runId}`).digest('hex').slice(0, 32);
62}
63
64/** The webhook URL for one run's event: relay URL, kind, channel, run id and sig. Nothing else. */
65export function runEventUrl(kind: 'alert' | 'run-end', runId: string, channel = 'monitor'): string {
66    const q = new URLSearchParams({ k: kind, ...(kind === 'alert' ? { ch: channel } : {}), r: runId, sig: runEventSig(runId) });
67    return `${ALERT_RELAY_URL}/v1/run-event?${q}`;
68}
69
70/**
71 * True when the relay answered /health in time and serves this bot. Never throws. A registered
72 * webhook cannot fall back, so a bot the relay would refuse must never be pointed at it.
73 */
74export async function alertRelayUp(timeoutMs = RELAY_PROBE_TIMEOUT_MS): Promise<boolean> {
75    if (!ALERT_RELAY_URL || typeof fetch !== 'function') return false;
76    try {
77        const res = await fetch(`${ALERT_RELAY_URL}/health?bot=${ALERT_BOT.split(':')[0]}`, { signal: AbortSignal.timeout(timeoutMs) });
78        return res.ok;
79    } catch {
80        return false;
81    }
82}
83
84/** Who sent an alert, for the relay's per-actor budget. The relay strips it before Telegram. */
85function relayMeta(): Record<string, string | number> {
86    const env = process.env;
87    return {
88        source: env.ACTOR_ID || env.APIFY_ACTOR_ID || '',
89        run: env.ACTOR_RUN_ID || env.APIFY_ACTOR_RUN_ID || '',
90        user: env.APIFY_USER_ID || '',
91        paying: env.APIFY_USER_IS_PAYING === '1' ? 1 : 0,
92    };
93}
94
95// ---- BEGIN redaction block: sync-failure-alerts.sh --redaction patches this span into forks ----
96// Mirrors redactSecrets/redactText in shared-run-telemetry/runTelemetry.ts (5490795), copied
97// rather than imported: not every consumer of this file holds runTelemetry.ts, and an older
98// copy of it there exports neither function.
99//
100// Key names whose value is a credential, at any depth, array items included.
101// `webhook` joined on 2026-09-25: whoever holds a Slack or Discord incoming-webhook URL
102// can post to that channel. `session`, `auth`, `credential`, `jwt`, `csrf` and `li_at`
103// joined on 2026-10-23 (see redactSecrets). `auth` skips `author…`/`authority`, so a search
104// field such as `authorName` stays readable; `authorization` has its own entry.
105const SENSITIVE_KEY_RE = /token|secret|password|passwd|api[-_]?key|cookie|bearer|authorization|auth(?!or)|session|credential|jwt|csrf|xsrf|private[-_]?key|access[-_]?key|webhook|(?:^|[^a-z])li_?at(?:$|[^a-z])/i;
106
107// Cookie names that ARE a login: a `{name, value}` pair under one of these names has its
108// value redacted, and so does `name=value` in a string. Matched on the whole name.
109const SESSION_COOKIE_NAME_RE = /^(?:li_at|li_a|li_rm|liap|li_mc|jsessionid|bcookie|bscookie|lidc|sessionid|session_id|sessid|phpsessid|connect\.sid|sid|ssid|hsid|apisid|sapisid|csrftoken|csrf_token|_csrf|xsrf-token|ds_user_id|c_user|xs|fr|datr|auth_token|ct0|twid|kdt|cf_clearance|__cf_bm|_abck|bm_sz|ak_bmsc|datadome|_px\w*|web_session|a1|at-main|sess-at-main|session-token|x-main|__secure-.+|__host-.+|_session.*|.*_session|.*sess(?:ion)?id.*|.*(?:auth(?!or)|token|csrf|xsrf).*)$/i;
110
111// The same names as they appear in a Cookie header or a pasted cookie string. Value of 4+
112// characters that is not already masked, so the pass is idempotent.
113const SESSION_COOKIE_PAIR_RE = /(?<![A-Za-z0-9_.-])(li_at|li_rm|liap|JSESSIONID|bcookie|bscookie|lidc|sessionid|session_id|PHPSESSID|connect\.sid|csrftoken|ds_user_id|c_user|xs|datr|auth_token|ct0|twid|cf_clearance|__cf_bm|_abck|bm_sz|datadome|web_session|at-main|sess-at-main|session-token|x-main|__Secure-[A-Za-z0-9_.-]+|__Host-[A-Za-z0-9_.-]+|_session[A-Za-z0-9_]*|[A-Za-z0-9]+_session)=(?!\*\*\*)(?:"[^"]{4,}"|[^\s;"',&]{4,})/gi;
114
115// A whole string that is a cookie header: two or more `name=value` pairs joined by `;`.
116const COOKIE_HEADER_RE = /^\s*(?:cookie:\s*)?[^\s=;,]+=[^;]*(?:;\s*[^\s=;,]+=[^;]*){1,}\s*;?\s*$/i;
117
118// Cookie attributes: an object that carries `name` and `value` plus one of these is a
119// browser-exported cookie, whatever its name.
120const COOKIE_ATTR_KEYS = ['domain', 'path', 'httpOnly', 'secure', 'expirationDate', 'expires', 'sameSite', 'hostOnly', 'session', 'storeId'];
121
122// The walk is bounded: depth, total nodes and per-string length. The Input line is cut at
123// 1,200 characters after this anyway, so a string is cut at 16 K first and the regexes
124// never see more than that.
125const REDACT_MAX_DEPTH = 20;
126const REDACT_MAX_NODES = 20_000;
127const REDACT_MAX_STRING = 16 * 1024;
128
129const REDACTED = '<redacted>';
130
131// Settings that share a word with a credential key and carry no secret: `useSessionPool:
132// true`, `maxSessions: 20`, `maxTokens: 500`. Booleans and null always stay; a number
133// stays only under a count-like key, so `password: 1234` still goes.
134const COUNT_KEY_RE = /^(?:max|min|num|use)(?:[A-Z_-]|$)|(?:count|size|limit|timeout|secs?|ms|retries|rotations|pages|age)$/i;
135function keepUnderSensitiveKey(k: string, x: unknown): boolean {
136    if (x == null || typeof x === 'boolean') return true;
137    return typeof x === 'number' && COUNT_KEY_RE.test(k);
138}
139
140/** A string value in the input with its credentials masked. */
141function redactInputString(s: string): string {
142    if (s.length > REDACT_MAX_STRING) s = `${s.slice(0, REDACT_MAX_STRING)}…(truncated)`;
143    // A pasted cookie header (`li_at=…; JSESSIONID=…`) goes whole: every pair in it is
144    // part of the login. A URL never matches.
145    if (s.includes('=') && s.includes(';') && !/^[a-z][a-z0-9+.-]*:\/\//i.test(s) && COOKIE_HEADER_RE.test(s)) return REDACTED;
146    return redactText(s);
147}
148
149/**
150 * The run's input with its credentials masked, for the alert's Input line.
151 *
152 * Until 2026-10-23 this went by key name alone, so a credential under a key that named
153 * nothing went to the Telegram channel in clear: a linkedin-company-people-scraper customer
154 * pasted a browser cookie export into the input root (keys `"0"`, `"1"` holding
155 * `{"name":"li_at","value":"…"}` and `{"name":"JSESSIONID","value":"…"}`, runs
156 * AHZZa38ExRe4yV3YA and WeMGMoloDeppSpRMe), and a Xiaohongshu buyer's `webSession` matched
157 * no key rule. Now, at any depth:
158 *  - a key named like a credential (SENSITIVE_KEY_RE) has its value replaced, unless the
159 *    value is a boolean or null, or a number under a count-like key (`maxSessions: 20`);
160 *  - an object holding `name`/`key` and `value` has the value replaced when the name is
161 *    a login cookie or a credential header (`Authorization`, `Cookie`), or when the
162 *    object also carries cookie attributes (`domain`, `httpOnly`, …);
163 *  - every string loses a cookie header, `li_at=…`-style pairs, bearer tokens, JWTs,
164 *    `key=value` credentials (redactText) and URL passwords and webhook paths.
165 * Names stay, so "the li_at cookie was given" is still readable in the alert.
166 */
167function redactSecrets(obj: unknown): unknown {
168    let nodes = 0;
169    const walk = (v: unknown, depth: number): unknown => {
170        if (v == null || typeof v === 'boolean' || typeof v === 'number') return v;
171        if (++nodes > REDACT_MAX_NODES || depth > REDACT_MAX_DEPTH) return '<truncated>';
172        if (typeof v === 'string') return redactInputString(v);
173        if (Array.isArray(v)) return v.map((x) => walk(x, depth + 1));
174        if (typeof v !== 'object') return v;
175        const o = v as Record<string, unknown>;
176        const pairName = typeof o.name === 'string' ? o.name : typeof o.key === 'string' ? o.key : null;
177        const isSecretPair = 'value' in o && pairName != null
178            && (SESSION_COOKIE_NAME_RE.test(pairName) || SENSITIVE_KEY_RE.test(pairName)
179                || COOKIE_ATTR_KEYS.some((a) => a in o));
180        const out: Record<string, unknown> = {};
181        for (const [k, x] of Object.entries(o)) {
182            if (isSecretPair && k === 'value') out[k] = x == null || x === '' ? x : REDACTED;
183            else if (isSecretPair && (k === 'name' || k === 'key')) out[k] = x;
184            else if (SENSITIVE_KEY_RE.test(k) && !keepUnderSensitiveKey(k, x)) out[k] = REDACTED;
185            // The whole userinfo, up to the LAST '@': a raw '@' in the password
186            // (`http://user:p@ss@host:8000`) used to leave `ss@host:8000` readable.
187            else if (k === 'proxyUrls' && Array.isArray(x))
188                out[k] = x.map((u: unknown) => (typeof u === 'string' ? redactInputString(u.replace(/:\/\/.*@/, '://***:***@')) : walk(u, depth + 1)));
189            else out[k] = walk(x, depth + 1);
190        }
191        return out;
192    };
193    try { return walk(obj, 0); } catch { return '(input redaction failed)'; }
194}
195
196/**
197 * The credentials a URL carries by itself: a password in the userinfo (up to the
198 * LAST '@' before whitespace or a quote), and the path of an incoming-webhook URL.
199 */
200function redactUrlSecrets(s: string): string {
201    return s
202        .replace(/(:\/\/[^:\s/]+):(?:[^\s"']*@|[^@\s]+@)/g, '$1:***@')
203        .replace(/(hooks\.slack\.com\/(?:services|workflows|triggers)\/|discord(?:app)?\.com\/api\/webhooks\/|webhook\.office\.com\/webhookb2\/)[^\s"'<>]+/gi, '$1***');
204}
205
206/**
207 * Credentials inside a string: URL passwords and webhook paths, bearer/basic/token values
208 * that look like credentials (a digit and 8+ characters, or 20+), JWTs, `key=value` and
209 * `key: value` credentials, and login cookie pairs by name. Prose stays: `Secret Garden`,
210 * `cookie prompt`, `Password reset page`, `The Light Bearer`. Idempotent.
211 * Same rules as redactText in runTelemetry.ts; the reasoning for each is kept there.
212 */
213function redactText(s: string): string {
214    // eslint-disable-next-line no-control-regex
215    return redactUrlSecrets(s.replace(/\u001b\[[0-9;]*[A-Za-z]/g, ''))
216        .replace(
217            /\b(bearer|basic|token)\s+(?=[A-Za-z0-9._\-~+/=]*[0-9])[A-Za-z0-9._\-~+/=]{8,}|\b(bearer|basic|token)\s+[A-Za-z0-9._\-~+/=]{20,}/gi,
218            (m) => m.replace(/\s+.*/, ' ***'),
219        )
220        .replace(/\beyJ[A-Za-z0-9._-]{10,}/g, '***')
221        .replace(
222            /(?<![A-Za-z0-9])((?:x-)?(?:api[-_]?key|access[-_]?token|auth[-_]?token|password|passwd|secret|authorization|auth|cookie|session[-_]?id|bearer|token)\\?["']?\s*[:=]\s*\\?["']?(?:(?:bearer|basic|digest|token)\s+)?)[^\s"',&]+(?:(?<=;)\s+[^\s"',&=]+=[^\s"',&]*)*/gi,
223            '$1***',
224        )
225        .replace(
226            /(?<![A-Za-z0-9])((?:x-)?(?:api[-_]?key|access[-_]?token|auth[-_]?token|password|passwd|secret|authorization|auth|cookie|session[-_]?id|bearer|token)\\?["']?\s+\\?["']?(?:(?:bearer|basic|digest|token)\s+)?)(?:(?=[A-Za-z0-9._\-~+/=]*[0-9])[A-Za-z0-9._\-~+/=]{8,}|[A-Za-z0-9._\-~+/=]{20,})(?:;(?:\s+[^\s"',&=]+=[^\s"',&]*)+)?/gi,
227            '$1***',
228        )
229        .replace(SESSION_COOKIE_PAIR_RE, '$1=***');
230}
231// ---- END redaction block ----
232
233/**
234 * The run's input, read once, and its compact, redacted, template-safe one-line view.
235 * `input` is null when it cannot be read. Registration needs the raw input as well as the
236 * line (see ownerSmokeInput), and a second getInput() would be one more storage read on
237 * every run of every actor.
238 */
239async function inputForAlert(): Promise<{ input: unknown; line: string }> {
240    let raw: unknown;
241    try { raw = (await Actor.getInput()) ?? {}; } catch { return { input: null, line: '(input unavailable)' }; }
242    let js = JSON.stringify(redactSecrets(raw));
243    // Neutralise any {{ }} in the input so Apify's string interpolation
244    // (shouldInterpolateStrings) can't try to substitute parts of the input.
245    js = js.replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }');
246    if (js.length > 1200) js = `${js.slice(0, 1200)}…(truncated)`;
247    return { input: raw, line: js };
248}
249
250/**
251 * Timeouts reach Telegram only for runs given at least this long.
252 *
253 * Of 234 timed-out runs fleet-wide from 2026-09-18 to 10-02 (out of 605,033), 209 had a
254 * timeout under 5 minutes, nearly all set by the customer or their integration (60 s, 90 s),
255 * and 206 of those had delivered nothing: the customer's choice, not a fault, and the bulk of
256 * the channel's noise. The 12 runs with a timeout of 15 minutes or more were the ones worth
257 * reading: jobs that ran out of time slowly, and the one real hang. Short-timeout runs are still
258 * recorded by run telemetry (a run-start with no run-end), so nothing is lost, only not pinged.
259 */
260export const TIMEOUT_ALERT_MIN_SECS = 900;
261
262/** The run's configured timeout in seconds, or null when the platform does not say. Same
263 *  derivation as runTelemetry.ts's timeoutSecs, so the alert and Axiom agree. */
264export function runTimeoutSecs(env: NodeJS.ProcessEnv = process.env, sdkEnv: any = null): number | null {
265    const toMs = (v: unknown): number => {
266        const ms = v instanceof Date ? v.getTime() : typeof v === 'string' ? Date.parse(v) : NaN;
267        return Number.isFinite(ms) && ms > 0 ? ms : NaN;
268    };
269    const timeoutMs = toMs(sdkEnv?.timeoutAt ?? env.ACTOR_TIMEOUT_AT ?? env.APIFY_TIMEOUT_AT);
270    const startMs = toMs(sdkEnv?.startedAt ?? env.ACTOR_STARTED_AT ?? env.APIFY_STARTED_AT);
271    if (!Number.isFinite(timeoutMs) || !Number.isFinite(startMs)) return null;
272    const secs = Math.round((timeoutMs - startMs) / 1000);
273    return secs > 0 ? secs : null;
274}
275
276/** The webhook's event types. TIMED_OUT is dropped only when the timeout is known and short;
277 *  an unreadable timeout keeps it, so a bad read can only make the channel louder. */
278export function alertEventTypes(timeoutSecs: number | null, alertOnAborted = true): string[] {
279    const types = ['ACTOR.RUN.FAILED'];
280    if (alertOnAborted) types.push('ACTOR.RUN.ABORTED');
281    if (timeoutSecs === null || timeoutSecs >= TIMEOUT_ALERT_MIN_SECS) types.push('ACTOR.RUN.TIMED_OUT');
282    return types;
283}
284
285/**
286 * Per-actor choices. Each one is what a fork used to hand-edit into its own copy before
287 * 2026-10-02; with them in canonical, those actors take every later fix from the sync.
288 */
289export interface FailureAlertOptions {
290    /**
291     * Alert on ABORTED runs. Default true. Turn it off where customers routinely stop their own
292     * runs, so ABORTED says nothing about the actor (seven forks did this by hand).
293     */
294    alertOnAborted?: boolean;
295    /**
296     * Start the alert with "[own account] " when the run belongs to the publishing account, so a
297     * test run is not opened as a customer incident (two were, on 2026-08-29 and 08-30). Decided
298     * here because payload templates have no conditionals. Default false.
299     */
300    tagOwnRuns?: boolean;
301    /**
302     * Lines added under "User:", worked out at registration, since the webhook cannot read the
303     * run's env when it fires. For example the plan flag:
304     * `Plan flag: ${process.env.APIFY_USER_IS_PAYING === '1' ? 'paying' : 'free'}`.
305     */
306    extraLines?: string[];
307}
308
309// memo23, the account that publishes these actors.
310const OWNER_USER_ID = 'ngn8vRESTkseyWE6p';
311
312/**
313 * Inputs that mark an owner run as a smoke test, with the values that do it.
314 *
315 * `debugForceProxyFallback` is left out of every input schema. It moves the residential-fallback
316 * module onto its backup lane, where a captcha wall cannot be cleared, to prove that lane works.
317 * How the run ends depends on the actor: Mercado Libre's smoke ended FAILED on 2026-10-25 and
318 * posted a real alert here (run eVAHkHM6oExWQczsm), and the same input SUCCEEDED on 2026-10-26
319 * once its rendered rescue lane was in (run Nr5Wy0fLGGaroxFvc). Either way the owner is watching
320 * the run. The values are the ones residentialFallback.ts acts on: `true`, and `"apify"` for its
321 * second backup.
322 */
323const SMOKE_INPUTS: Record<string, unknown[]> = {
324    debugForceProxyFallback: [true, 'apify'],
325};
326
327/**
328 * The input that makes this an owner smoke run, or null.
329 *
330 * Owner runs only. A customer who sets a hidden debug input is unexpected, so their run still
331 * alerts. A skipped run is still in run telemetry (run-start and run-end), so nothing is lost;
332 * it only stays out of the channel.
333 */
334export function ownerSmokeInput(input: unknown, userId = process.env.APIFY_USER_ID): string | null {
335    if (userId !== OWNER_USER_ID || !input || typeof input !== 'object') return null;
336    for (const [key, values] of Object.entries(SMOKE_INPUTS)) {
337        if (values.includes((input as Record<string, unknown>)[key])) return key;
338    }
339    return null;
340}
341
342// Id of the webhook this run registered, for unregisterFailureAlertWebhook.
343let registeredWebhookId: string | null = null;
344
345const webhookId = (wh: unknown): string | null => (wh as { id?: string } | undefined)?.id ?? null;
346
347export async function registerFailureAlertWebhook(brand: string, options: FailureAlertOptions = {}): Promise<void> {
348    // Before the platform check, so a local run ends the same way (see the end of this file).
349    await installAccountUsageLimitHandling();
350    // Platform webhooks only exist on the Apify platform — locally there's no run
351    // for the backend to attach to, so skip cleanly (no-op, no warning spam).
352    const runId = process.env.ACTOR_RUN_ID || process.env.APIFY_ACTOR_RUN_ID;
353    if (!runId) return;
354    try {
355        const { input, line: inputLine } = await inputForAlert();
356        // The owner started this smoke run and is watching it, however it ends.
357        const smokeInput = ownerSmokeInput(input);
358        if (smokeInput) {
359            console.log(`[FAIL-ALERT] not registered: own smoke run (${smokeInput})`);
360            return;
361        }
362        const ownRunTag = options.tagOwnRuns && process.env.APIFY_USER_ID === OWNER_USER_ID ? '[own account] ' : '';
363        // Same {{ }} neutralising as the input line: an extra line is text, never a template.
364        const extraText = (options.extraLines ?? [])
365            .map((l) => `${l.replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }').replace(/\n/g, ' ')}\n`)
366            .join('');
367        // The whole options object is cast to `any` so this compiles across apify
368        // SDK versions — older WebhookOptions types omit headersTemplate, and the
369        // eventTypes string literals need widening regardless.
370        const baseOpts = {
371            eventTypes: alertEventTypes(
372                runTimeoutSecs(process.env, (() => { try { return (Actor as any).getEnv?.(); } catch { return null; } })()),
373                options.alertOnAborted ?? true,
374            ),
375            // No token and no chat id: the relay holds both. If the relay is down when the run ends,
376            // Apify retries the delivery (11 times over ~32 h), so the alert is late, not lost.
377            requestUrl: runEventUrl('alert', runId),
378            payloadTemplate: JSON.stringify({
379                // Filled in by Apify at fire time; the relay checks it against the signed run id.
380                run: '{{resource.id}}',
381                // shouldInterpolateStrings:true is REQUIRED so {{...}} inside this
382                // text string gets substituted (default only substitutes whole-field
383                // placeholders). Without it the channel shows literal {{eventType}}.
384                text: `${ownRunTag}${brand} {{eventType}}\n`
385                    + 'Run: https://console.apify.com/actors/{{resource.actId}}/runs/{{resource.id}}\n'
386                    + 'User: {{userId}}\n'
387                    + extraText
388                    + 'Started: {{resource.startedAt}}\n'
389                    + 'Finished: {{resource.finishedAt}}\n'
390                    // resource.status is always set (FAILED/ABORTED/TIMED-OUT); statusMessage
391                    // is empty on hard kills (OOM/SIGKILL) and rendered "undefined". exitCode
392                    // is the diagnosis shortcut: 137 = OOM/SIGKILL.
393                    + 'Status: {{resource.status}} (exit code {{resource.exitCode}})\n'
394                    // Reason = the actor's own terminal status message (what it passed to
395                    // Actor.fail() / Actor.exit({ statusMessage })) — the only field in the whole
396                    // payload that says WHY a run failed: `Couldn't resolve location "lpa" …`, a
397                    // run guard's zero-item message, a validation error. For a CUSTOMER run there
398                    // is nowhere else to read it at all — the log lives in their account.
399                    // KEEP this line even though it renders the literal "undefined" on hard kills
400                    // (see the note above): payload templates have no conditionals, and no other
401                    // field in the payload carries a reason there either — resource.stats,
402                    // .options and .meta are memory/CPU counters, limits and an origin string.
403                    // Exit code 137 / status TIMED_OUT / ABORTED on the Status line already
404                    // diagnose those cases; this line is what makes every OTHER failure readable.
405                    + 'Reason: {{resource.statusMessage}}\n'
406                    + `Input: ${inputLine}`,
407                // Run, actor and user come from Apify at fire time; the plan flag is known only now.
408                alert_meta: {
409                    source: '{{resource.actId}}',
410                    run: '{{resource.id}}',
411                    user: '{{userId}}',
412                    paying: relayMeta().paying,
413                    label: brand.replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }'),
414                },
415            }),
416            // Run-scoped key so a resurrected run doesn't register a 2nd webhook.
417            idempotencyKey: `fail-alert-${runId}`,
418            shouldInterpolateStrings: true,
419        };
420        try {
421            // `headersTemplate` pins Content-Type — supported on newer apify-client (≳ 2.22).
422            // The `any` is load-bearing: this file ships to actors pinned to a range of
423            // apify-client versions, and on the older ones `headersTemplate` is not in the
424            // typings at all. A narrower assertion would fail to compile on exactly the
425            // versions the try/catch below exists to support.
426            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- see above
427            registeredWebhookId = webhookId(await Actor.addWebhook({ ...baseOpts, headersTemplate: JSON.stringify({ 'Content-Type': 'application/json' }) } as any));
428        } catch {
429            // Older apify-client (e.g. 2.21, SDK 3.5.x) rejects `headersTemplate`
430            // ("Did not expect property …") → retry without it. Apify dispatches webhooks
431            // as application/json by default, which Telegram's sendMessage accepts.
432            try {
433                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- same version spread as above
434                registeredWebhookId = webhookId(await Actor.addWebhook(baseOpts as any));
435            } catch (e) {
436                // SDK 3.5.x also rejects `shouldInterpolateStrings` ("Did not expect property
437                // `shouldInterpolateStrings` to exist"). Dropping the flag would post the literal
438                // {{eventType}} text, so create the same run-scoped ad-hoc webhook through the API
439                // client, which is what Actor.addWebhook does internally, minus the option check.
440                // Seen on agarmap and forrent (apify 3.5.3), 2026-09-29.
441                if (!/shouldInterpolateStrings/.test((e as Error).message)) throw e;
442                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- the create() typings on old clients lack these fields
443                registeredWebhookId = webhookId(await Actor.newClient().webhooks().create({ ...baseOpts, isAdHoc: true, condition: { actorRunId: runId } } as any));
444            }
445        }
446        console.log('[FAIL-ALERT] failure/abort webhook registered (via alert relay, with input)');
447    } catch (e) {
448        console.warn('[FAIL-ALERT] failed to register failure webhook (non-fatal):', (e as Error).message);
449    }
450}
451
452/**
453 * Remove the webhook this run registered, so the run can end FAILED without an alert. For a
454 * deliberate Actor.fail() on a buyer's configuration mistake: the channel should carry real
455 * breakage only. Call it right before failing; a no-op when nothing was registered.
456 */
457export async function unregisterFailureAlertWebhook(): Promise<void> {
458    if (!registeredWebhookId) return;
459    try {
460        await Actor.apifyClient.webhook(registeredWebhookId).delete();
461        registeredWebhookId = null;
462        console.log('[FAIL-ALERT] webhook removed, this run will not alert');
463    } catch (e) {
464        console.warn('[FAIL-ALERT] could not remove the webhook, this run may still alert:', (e as Error).message);
465    }
466}
467
468/**
469 * Post one line to the alerts channel now, for a condition that does not fail the run (a dead
470 * API key at startup, a fallback path taking over). Relay first (3 s), then straight to Telegram
471 * (10 s) if the relay is down or refuses. Best effort: never throws, so an alert can never fail
472 * the run.
473 */
474export async function sendAlert(text: string): Promise<void> {
475    const body = { chat_id: ALERT_CHAT, text, disable_web_page_preview: true };
476    const post = (base: string, payload: object, timeoutMs: number) => fetch(`${base}/bot${ALERT_BOT}/sendMessage`, {
477        method: 'POST',
478        headers: { 'Content-Type': 'application/json' },
479        body: JSON.stringify(payload),
480        signal: AbortSignal.timeout(timeoutMs),
481    });
482    try {
483        if ((await post(ALERT_RELAY_URL, { ...body, alert_meta: relayMeta() }, 3_000)).ok) return;
484    } catch { /* relay unreachable: send direct */ }
485    try {
486        await post('https://api.telegram.org', body, 10_000);
487    } catch { /* best effort */ }
488}
489
490// ── The buyer's account past its usage limit ────────────────────────────────────────────────────
491// Once a buyer's account passes the monthly usage limit set in its billing settings, the platform
492// answers every storage call with 403 "Monthly usage hard limit exceeded" (type
493// platform-feature-disabled), in the middle of a run. Crawlee cannot even put a failed request back
494// in the queue, crawler.run() rejects, and the run dies on a stack trace whose alert reads like a
495// broken actor: Redfin run icN20mf8qpCGwNmJr on 2026-10-19 saved 28 of 100 listings and alerted
496// "Crawled 21/100 pages, 0 failed requests". registerFailureAlertWebhook() therefore makes every
497// Crawlee crawler.run() end such a run FAILED with one plain line and without an alert. An actor
498// without Crawlee can call endRunOnAccountUsageLimit() from its own catch.
499
500/** The platform's refusal once the run's account is past its usage limit, or has a feature turned
501 *  off that the run needs. Checked on the error and on its cause. */
502export function isAccountUsageLimitError(err: unknown): boolean {
503    for (const e of [err, (err as { cause?: unknown } | null | undefined)?.cause]) {
504        const { type, message } = (e ?? {}) as { type?: unknown; message?: unknown };
505        if (type === 'platform-feature-disabled' || /monthly usage hard limit/i.test(String(message ?? ''))) return true;
506    }
507    return false;
508}
509
510function accountUsageLimitMessage(platformMessage: string, saved: number): string {
511    const savedText = saved > 0
512        ? `${saved} result(s) were saved to the dataset before it stopped.`
513        : 'Anything saved before that is in the dataset.';
514    return /monthly usage hard limit/i.test(platformMessage)
515        ? `Your Apify account reached its monthly usage limit during this run, so Apify stopped serving the run. ${savedText} `
516            + 'To get the rest, raise the monthly usage limit in your Apify billing settings (or wait for the next billing cycle) and run again.'
517        : `Apify turned off a platform feature this run needs on your account ("${platformMessage}"), so the run stopped. ${savedText}`;
518}
519
520let accountLimitExplained = false;
521
522/**
523 * End the run FAILED with a plain reason for the buyer and no alert for us: the buyer's own limit,
524 * not a fault in the actor. Every step is best effort, since the same limit may refuse the status
525 * message and the webhook delete too; the log line always lands. Actor.fail() exits the process.
526 */
527export async function endRunOnAccountUsageLimit(err: unknown): Promise<void> {
528    const platformMessage = String((err as { message?: unknown } | null | undefined)?.message ?? err);
529    // run-telemetry sits beside this file in most actors: it has the saved-row count, and the
530    // run-end event the crash would never send. A computed specifier, so an actor without it compiles.
531    type Telemetry = { getPushedItemCount?: () => number; finishRunTelemetry?: (status: string, extra: Record<string, unknown>) => Promise<void> };
532    let telemetry: Telemetry | null = null;
533    try { const spec = './runTelemetry.js'; telemetry = (await import(spec)) as Telemetry; } catch { /* not in this actor */ }
534    let saved = 0;
535    try { saved = Number(telemetry?.getPushedItemCount?.()) || 0; } catch { /* count unknown */ }
536    const msg = accountUsageLimitMessage(platformMessage, saved);
537    accountLimitExplained = true;
538    console.error(`[ACCOUNT-LIMIT] ${msg}`);
539    // Set now as well as at exit: if a refused storage call kills the process on the way out,
540    // the reason is already on the run.
541    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- the options argument differs across SDK versions
542    try { await (Actor as any).setStatusMessage(msg, { isStatusMessageTerminal: true, level: 'ERROR' }); } catch { /* refused */ }
543    await unregisterFailureAlertWebhook();
544    try {
545        await telemetry?.finishRunTelemetry?.('FAILED', { failureReason: 'account_usage_limit', errorMessage: msg, failClass: 'customer_account' });
546    } catch { /* telemetry is best effort */ }
547    await Actor.fail(msg);
548}
549
550let accountLimitHandlingInstalled = false;
551
552async function installAccountUsageLimitHandling(): Promise<void> {
553    if (accountLimitHandlingInstalled) return;
554    accountLimitHandlingInstalled = true;
555
556    // Every Crawlee crawler runs through BasicCrawler.prototype.run. Computed specifiers, so an
557    // actor without Crawlee compiles and skips this.
558    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Crawlee is optional here
559    let basic: any = null;
560    for (const spec of ['@crawlee/basic', 'crawlee']) {
561        try { basic = await import(spec); } catch { basic = null; }
562        if (basic?.BasicCrawler) break;
563    }
564    const proto = basic?.BasicCrawler?.prototype;
565    if (proto && typeof proto.run === 'function' && !proto.run.__accountLimitWrapped) {
566        const run = proto.run;
567        const wrapped = async function (this: unknown, ...args: unknown[]) {
568            try {
569                return await run.apply(this, args);
570            } catch (err) {
571                if (isAccountUsageLimitError(err)) await endRunOnAccountUsageLimit(err);
572                throw err;
573            }
574        };
575        (wrapped as unknown as { __accountLimitWrapped: boolean }).__accountLimitWrapped = true;
576        proto.run = wrapped;
577    }
578
579    // The error can escape elsewhere too (a storage call after the crawl, or an actor without
580    // Crawlee). Then the actor's crash guard exits the run; this only puts the plain reason in the
581    // log above its stack trace. Added only in front of a handler that is already there: a listener
582    // of our own would switch off Node's default crash and leave the run hanging instead.
583    const explain = (err: unknown) => {
584        if (accountLimitExplained || !isAccountUsageLimitError(err)) return;
585        accountLimitExplained = true;
586        console.error(`[ACCOUNT-LIMIT] ${accountUsageLimitMessage(String((err as { message?: unknown } | null)?.message ?? err), 0)}`);
587    };
588    if (process.listenerCount('uncaughtException') > 0) process.prependListener('uncaughtException', explain);
589    if (process.listenerCount('unhandledRejection') > 0) process.prependListener('unhandledRejection', explain);
590}

src/lib/parser.ts

1/**
2 * OpenCorporates detail-page parser.
3 *
4 * Every company page has one `#attributes dl.attributes` list of dt/dd pairs.
5 * Which rows appear depends on the jurisdiction (GB has industry codes and
6 * accounts dates, US has agents and filings, NL has restrictions), so we read
7 * the known rows into typed fields and keep anything else in `otherAttributes`.
8 *
9 * Anonymous pages replace some values with a "Please log in to see this data"
10 * link. Those come back as null and their names go into `loginRequiredFields`,
11 * so the placeholder text never reaches the dataset.
12 */
13import type { Cheerio, CheerioAPI } from 'cheerio';
14import type { AnyNode } from 'domhandler';
15
16const BASE = 'https://opencorporates.com';
17
18export interface Officer {
19    name: string;
20    position: string;
21    startDate: string | null;
22    endDate: string | null;
23    isActive: boolean;
24    isCorporate: boolean;
25    link: string;
26}
27
28export interface DataSource {
29    name: string | null;
30    url: string | null;
31    lastUpdateFromSource: string | null;
32    lastChangeRecorded: string | null;
33    nextUpdateFromSource: string | null;
34}
35
36export interface Identifier {
37    type: string;
38    value: string;
39}
40
41export interface Filing {
42    date: string;
43    title: string;
44    url: string | null;
45}
46
47export interface CompanyDetails {
48    name: string;
49    companyNumber: string;
50    status: string | null;
51    incorporationDate: string | null;
52    dissolutionDate: string | null;
53    companyType: string | null;
54    jurisdiction: string | null;
55    jurisdictionCode: string | null;
56    registeredAddress: string | null;
57    registeredAddressLines: string[];
58    agentName: string | null;
59    agentAddress: string | null;
60    industryCodes: string[];
61    previousNames: string[];
62    previousCompanyNumbers: string[];
63    otherIdentifiers: Identifier[];
64    latestAccountsDate: string | null;
65    annualReturnLastMadeUpDate: string | null;
66    registryPage: string | null;
67    officersCount: number | null;
68    inactiveOfficersCount: number | null;
69    beneficialOwnersCount: number | null;
70    beneficialOwners: string[];
71    directorsOfficers: Officer[];
72    recentFilings: Filing[];
73    dataSource: DataSource | null;
74    otherAttributes: Record<string, string>;
75    loginRequiredFields: string[];
76}
77
78// Placeholder "officers" some US registries list instead of a person.
79const PLACEHOLDER_OFFICERS = ['no agent', 'registered agents inc', 'secretary of state'];
80const CORPORATE_KEYWORDS = [
81    '.com', 'inc.', 'inc', 'llc', 'llp', 'ltd', 'corporation', 'corp.', 'limited', 'company', 'plc',
82    'gmbh', 'b.v.', 'n.v.', 's.a.', 'sarl', 'services', 'nominees', 'secretaries', 'trust',
83];
84
85function isCorporateName(name: string): boolean {
86    const words = name.toLowerCase().split(/[\s,]+/);
87    return CORPORATE_KEYWORDS.some((k) => (k.includes('.') ? name.toLowerCase().includes(k) : words.includes(k)));
88}
89
90/** "<span datetime="2006-10-05"> 5 October 2006</span> (about 20 years ago)" -> "2006-10-05" */
91function dateValue($dd: Cheerio<AnyNode>): string | null {
92    const iso = $dd.find('[datetime]').attr('datetime');
93    if (iso) return iso;
94    return clean($dd.text()).replace(/\s*\([^)]*\)\s*$/, '') || null;
95}
96
97const clean = (s: string): string => s.replace(/\s+/g, ' ').trim();
98
99function camelCase(label: string): string {
100    const words = label.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim().split(' ').filter(Boolean);
101    return words.map((w, i) => (i === 0 ? w : w[0].toUpperCase() + w.slice(1))).join('');
102}
103
104function isGated($dd: Cheerio<AnyNode>): boolean {
105    return $dd.find('a[href*="/users/sign_in"]').length > 0 || /please log in/i.test($dd.text());
106}
107
108/** "2 officers available, please log in" / "3 UBOs listed, ..." -> 2 / 3 */
109function leadingCount(text: string): number | null {
110    const m = text.match(/^\s*([\d,]+)\s/);
111    return m ? Number(m[1].replace(/,/g, '')) : null;
112}
113
114/** <li> texts of a dd, with <br> turned into ", " so lines never run together. */
115function listItems($: CheerioAPI, $dd: Cheerio<AnyNode>): string[] {
116    const items: string[] = [];
117    $dd.find('li').each((_, li) => {
118        const $li = $(li).clone();
119        $li.find('br').replaceWith(', ');
120        const t = clean($li.text()).replace(/(,\s*)+$/, '');
121        if (t) items.push(t);
122    });
123    return items;
124}
125
126function extractOfficers($: CheerioAPI, $dd: Cheerio<AnyNode>, isActive: boolean, out: Officer[]): void {
127    $dd.find('li').each((_, elem) => {
128        const $elem = $(elem);
129        const $link = $elem.find('a.officer').first();
130        const name = clean($link.text());
131        if (!name) return;
132        if (PLACEHOLDER_OFFICERS.some((k) => name.toLowerCase().includes(k))) return;
133        // "<a>NAME</a>, director, <span class=start_date>1 Oct 2010</span>-<span class=end_date>...</span>"
134        const $rest = $elem.clone();
135        $rest.find('a.officer, .start_date, .end_date').remove();
136        const position = clean($rest.text()).replace(/^,\s*/, '').replace(/[,\s-]+$/, '') || 'unknown';
137        const href = $link.attr('href');
138        out.push({
139            name,
140            position,
141            startDate: clean($elem.find('.start_date').text()) || null,
142            endDate: clean($elem.find('.end_date').text()) || null,
143            isActive,
144            isCorporate: isCorporateName(name),
145            link: href ? new URL(href, BASE).href : '',
146        });
147    });
148}
149
150export function parseCompanyDetails($: CheerioAPI, includeOfficers: boolean, url?: string): CompanyDetails {
151    const details: CompanyDetails = {
152        name: clean($('.vcard h1.fn.org').first().text()),
153        companyNumber: '',
154        status: null,
155        incorporationDate: null,
156        dissolutionDate: null,
157        companyType: null,
158        jurisdiction: null,
159        jurisdictionCode: url?.match(/\/companies\/([a-z]{2}(?:_[a-z0-9]{2,3})?)\//i)?.[1].toLowerCase() ?? null,
160        registeredAddress: null,
161        registeredAddressLines: [],
162        agentName: null,
163        agentAddress: null,
164        industryCodes: [],
165        previousNames: [],
166        previousCompanyNumbers: [],
167        otherIdentifiers: [],
168        latestAccountsDate: null,
169        annualReturnLastMadeUpDate: null,
170        registryPage: null,
171        officersCount: null,
172        inactiveOfficersCount: null,
173        beneficialOwnersCount: null,
174        beneficialOwners: [],
175        directorsOfficers: [],
176        recentFilings: [],
177        dataSource: null,
178        otherAttributes: {},
179        loginRequiredFields: [],
180    };
181
182    $('#attributes dl.attributes > dt').each((_, dt) => {
183        const label = clean($(dt).text());
184        const $dd = $(dt).next('dd');
185        if (!label || !$dd.length) return;
186        const key = camelCase(label);
187        const text = clean($dd.text());
188        const gated = isGated($dd);
189
190        switch (key) {
191            case 'directorsOfficers':
192            case 'inactiveDirectorsOfficers': {
193                const isActive = key === 'directorsOfficers';
194                if (gated) {
195                    if (isActive) details.officersCount = leadingCount(text);
196                    else details.inactiveOfficersCount = leadingCount(text);
197                    details.loginRequiredFields.push(key);
198                } else {
199                    const count = $dd.find('a.officer').length;
200                    if (isActive) details.officersCount = count;
201                    else details.inactiveOfficersCount = count;
202                    if (includeOfficers) extractOfficers($, $dd, isActive, details.directorsOfficers);
203                }
204                return;
205            }
206            case 'ultimateBeneficialOwners':
207                if (gated) {
208                    details.beneficialOwnersCount = leadingCount(text);
209                    details.loginRequiredFields.push(key);
210                } else {
211                    details.beneficialOwners = listItems($, $dd);
212                    details.beneficialOwnersCount = details.beneficialOwners.length || leadingCount(text);
213                }
214                return;
215            default:
216                break;
217        }
218
219        if (gated) {
220            details.loginRequiredFields.push(key);
221            return;
222        }
223
224        switch (key) {
225            case 'companyNumber': details.companyNumber = text; break;
226            case 'status': details.status = text || null; break;
227            case 'incorporationDate': details.incorporationDate = dateValue($dd); break;
228            case 'dissolutionDate': details.dissolutionDate = dateValue($dd); break;
229            case 'companyType': details.companyType = text || null; break;
230            case 'jurisdiction': details.jurisdiction = text || null; break;
231            case 'registeredAddress':
232                details.registeredAddressLines = listItems($, $dd);
233                details.registeredAddress = details.registeredAddressLines.join(', ') || text || null;
234                break;
235            case 'agentName': details.agentName = text || null; break;
236            case 'agentAddress': details.agentAddress = text || null; break;
237            case 'industryCodes': details.industryCodes = listItems($, $dd); break;
238            case 'previousNames': details.previousNames = listItems($, $dd); break;
239            case 'previousCompanyNumbers': details.previousCompanyNumbers = listItems($, $dd); break;
240            case 'otherIdentifiers':
241                details.otherIdentifiers = listItems($, $dd).map((item) => {
242                    const i = item.lastIndexOf(':');
243                    return i > 0
244                        ? { type: item.slice(0, i).trim(), value: item.slice(i + 1).trim() }
245                        : { type: '', value: item };
246                });
247                break;
248            case 'latestAccountsDate': details.latestAccountsDate = text || null; break;
249            case 'annualReturnLastMadeUpDate': details.annualReturnLastMadeUpDate = text || null; break;
250            case 'registryPage': details.registryPage = $dd.find('a').attr('href') || null; break;
251            default: {
252                const items = listItems($, $dd);
253                const value = items.length ? items.join('; ') : text;
254                if (value) details.otherAttributes[key] = value;
255            }
256        }
257    });
258
259    // "Data source and freshness" sidebar; the source link is login-only.
260    const $source = $('.sidebar.freshness dl.attributes');
261    if ($source.length) {
262        const side: Record<string, Cheerio<AnyNode>> = {};
263        $source.children('dt').each((_, dt) => {
264            const $dd = $(dt).next();
265            if ($dd.is('dd')) side[camelCase($(dt).text())] = $dd;
266        });
267        const $src = side.source;
268        if ($src && isGated($src)) {
269            details.loginRequiredFields.push('dataSource');
270        } else if ($src) {
271            const val = (k: string) => (side[k] && !isGated(side[k]) ? clean(side[k].text()) || null : null);
272            const href = $src.find('a').attr('href') ?? null;
273            details.dataSource = {
274                name: clean($src.text()) || null,
275                url: href,
276                lastUpdateFromSource: val('lastUpdateFromSource'),
277                lastChangeRecorded: val('lastChangeRecorded'),
278                nextUpdateFromSource: val('nextUpdateFromSource'),
279            };
280            details.registryPage ??= href;
281        }
282    }
283
284    $('#filings .filing').each((_, el) => {
285        const $f = $(el);
286        const $a = $f.find('.subhead a').first();
287        const title = clean($a.text());
288        if (!title) return;
289        const href = $a.attr('href');
290        details.recentFilings.push({
291            date: clean($f.find('.dateline').text()),
292            title,
293            url: href ? new URL(href, BASE).href : null,
294        });
295    });
296
297    return details;
298}
299
300/** Detect an anti-bot challenge in a response body. */
301export function isChallenge(body: string): boolean {
302    if (body.includes('leastFactor')) return true;
303    if (body.includes('Checking your browser')) return true;
304    if (body.includes('google.com/recaptcha/challengepage')) return true;
305    return false;
306}
307
308/**
309 * Normalise a company detail URL (adds https, drops query/hash/trailing slash).
310 * Returns null when the URL is not an opencorporates.com/companies/{jur}/{number} page.
311 */
312export function normalizeCompanyUrl(raw: string): string | null {
313    let s = raw.trim();
314    if (!s) return null;
315    if (!/^https?:\/\//i.test(s)) s = `https://${s.replace(/^\/+/, '')}`;
316    let u: URL;
317    try {
318        u = new URL(s);
319    } catch {
320        return null;
321    }
322    if (!/(^|\.)opencorporates\.com$/i.test(u.hostname)) return null;
323    const m = u.pathname.match(/^\/companies\/([a-z]{2}(?:_[a-z0-9]{2,3})?)\/([^/]+)\/?$/i);
324    if (!m) return null;
325    return `${BASE}/companies/${m[1].toLowerCase()}/${m[2]}`;
326}

src/lib/recordStore.ts

1/**
2 * Permanent record store: what we already know about a thing, keyed by the site's own id.
3 *
4 * CANONICAL COPY: ~/projects/shared-record-store/recordStore.ts. Edit it THERE and run
5 * ./sync-record-store.sh; never hand-edit an actor's copy.
6 *
7 * Different from the page cache (shared-unblock/pageCache.ts) on purpose:
8 *   - it holds a PARSED record, not a page body — 1-8 KB a thing against 138 KB a page;
9 *   - its key is (source, entityId), with NO account in it, so one customer's fetch can answer
10 *     another's lookup;
11 *   - it has no TTL; each row carries last_confirmed, and the caller decides how old is too old.
12 *
13 * Because rows are shared across customers, this module is only for business and product data.
14 * People-search records stay on the per-account page cache: a permanent cross-customer archive of
15 * private individuals' phones, emails and home addresses is a different product with a different
16 * legal footing, and the measured cross-customer repeat rate there (1.4-7.1%) does not pay for it.
17 *
18 * Built first for D&B in SHADOW mode: the actor looks a company up, still fetches it live, and
19 * reports whether the store already had it and whether the live record differed. That measures the
20 * hit rate and the real change rate before any customer is served a stored row.
21 *
22 * Batch by default: a run looks up dozens of ids at once, and one round trip beats dozens.
23 * Every failure is swallowed — a store that is down must cost a run nothing beyond the fetch it was
24 * trying to avoid. Credentials are hardcoded per portfolio convention.
25 */
26
27// Default database. A consumer with its own database calls configureRecordStore() before its first
28// read or write.
29let DB_URL = 'libsql://zillow-agents-memo23.aws-eu-west-1.turso.io';
30let AUTH_TOKEN = 'eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJhIjoicnciLCJpYXQiOjE3ODEwMjIwOTQsImlkIjoiMDE5ZWFkMmUtN2MwMS03NGE5LWJiZTMtNzhkNzI3N2E3Y2YyIiwicmlkIjoiNzAwZWZiNWItOGM3MS00MjUwLTlhZmMtMDVmZmJiMTRjZDQxIn0.oA3y7pt2_7CPHuixcRmvx19zh32ffZQ1hKSifPKwwtEP9nMLA41q2ScFHtWiPi3la3o7XOmdutAZTwQNwUudAw';
31const TABLE = 'record_store';
32/** A stalled store must fail fast: the live fetch it shadows is the fallback. */
33const TIMEOUT_MS = 6_000;
34/** Ids per SELECT. Keeps a statement well under libSQL's parameter limit. */
35const READ_CHUNK = 100;
36/** A record this large is not a record; it is a page that slipped through. */
37const MAX_RECORD_BYTES = 200_000;
38
39export interface StoredRecord<T = unknown> {
40    record: T;
41    schemaVer: number;
42    firstSeen: number;
43    lastConfirmed: number;
44}
45
46export const recordCounters = {
47    /** ids asked for */
48    lookups: 0,
49    /** found, right schema, young enough */
50    hits: 0,
51    /** found but too old or written under a different schema — refetched */
52    stale: 0,
53    misses: 0,
54    writes: 0,
55    tooLarge: 0,
56    errors: 0,
57};
58
59export function resetRecordCounters(): void {
60    for (const k of Object.keys(recordCounters) as (keyof typeof recordCounters)[]) recordCounters[k] = 0;
61}
62
63type Arg = { type: 'text'; value: string } | { type: 'integer'; value: string };
64const text = (v: string): Arg => ({ type: 'text', value: v });
65const int = (v: number): Arg => ({ type: 'integer', value: String(Math.trunc(v)) });
66type Stmt = { sql: string; args?: Arg[] };
67
68let schemaReady: Promise<void> | null = null;
69let disabled = false;
70
71async function pipeline(stmts: Stmt[]): Promise<{ cols: string[]; rows: unknown[][] }[]> {
72    const endpoint = `${DB_URL.replace(/^libsql:\/\//, 'https://').replace(/\/+$/, '')}/v2/pipeline`;
73    const res = await fetch(endpoint, {
74        method: 'POST',
75        headers: { Authorization: `Bearer ${AUTH_TOKEN}`, 'Content-Type': 'application/json' },
76        body: JSON.stringify({ requests: [...stmts.map((stmt) => ({ type: 'execute', stmt })), { type: 'close' }] }),
77        signal: AbortSignal.timeout(TIMEOUT_MS),
78    });
79    if (!res.ok) throw new Error(`turso:${res.status}`);
80    const json = (await res.json()) as {
81        results?: { type: string; error?: { message?: string }; response?: { result?: { cols?: { name: string }[]; rows?: { value: unknown }[][] } } }[];
82    };
83    const out: { cols: string[]; rows: unknown[][] }[] = [];
84    for (const r of json.results ?? []) {
85        if (r.type === 'error') throw new Error(`turso:${r.error?.message ?? 'statement failed'}`);
86        if (r.type !== 'ok' || !r.response?.result) continue;
87        out.push({
88            cols: (r.response.result.cols ?? []).map((c) => c.name),
89            rows: (r.response.result.rows ?? []).map((row) => row.map((c) => c?.value ?? null)),
90        });
91    }
92    return out;
93}
94
95async function ready(): Promise<void> {
96    schemaReady ??= pipeline([
97        {
98            sql: `CREATE TABLE IF NOT EXISTS ${TABLE} (
99                source TEXT NOT NULL, entity_id TEXT NOT NULL, record TEXT NOT NULL,
100                schema_ver INTEGER NOT NULL, first_seen INTEGER NOT NULL, last_confirmed INTEGER NOT NULL,
101                PRIMARY KEY (source, entity_id))`,
102        },
103        { sql: `CREATE INDEX IF NOT EXISTS ${TABLE}_confirmed ON ${TABLE} (source, last_confirmed)` },
104    ]).then(async () => {
105        // Demand tracking, added 2026-10-30. Older tables get the columns here. An ALTER that
106        // fails (usually: the column is already there) must not take reads and writes down with
107        // it; only markServed and listRefreshCandidates need these columns.
108        for (const sql of [
109            `ALTER TABLE ${TABLE} ADD COLUMN serve_count INTEGER NOT NULL DEFAULT 0`,
110            `ALTER TABLE ${TABLE} ADD COLUMN last_served INTEGER`,
111        ]) {
112            try { await pipeline([{ sql }]); } catch { /* already migrated, or not ours to migrate */ }
113        }
114    });
115    try {
116        return await schemaReady;
117    } catch (err) {
118        // Never memoise a rejection: one blip at run start must not disable the store for the run.
119        schemaReady = null;
120        throw err;
121    }
122}
123
124/**
125 * Look up many ids at once. Returns only usable rows: right schema, confirmed within maxConfirmAgeMs.
126 * Rows that exist but fail either test are counted as stale and left out. Never throws.
127 */
128export async function readRecords<T = unknown>(
129    source: string,
130    ids: string[],
131    schemaVer: number,
132    maxConfirmAgeMs: number,
133): Promise<Map<string, StoredRecord<T>>> {
134    const found = new Map<string, StoredRecord<T>>();
135    const unique = [...new Set(ids.filter(Boolean))];
136    recordCounters.lookups += unique.length;
137    if (disabled || maxConfirmAgeMs <= 0 || unique.length === 0) {
138        recordCounters.misses += unique.length;
139        return found;
140    }
141    try {
142        await ready();
143        const cutoff = Date.now() - maxConfirmAgeMs;
144        let seen = 0;
145        for (let i = 0; i < unique.length; i += READ_CHUNK) {
146            const chunk = unique.slice(i, i + READ_CHUNK);
147            const [res] = await pipeline([{
148                sql: `SELECT entity_id, record, schema_ver, first_seen, last_confirmed FROM ${TABLE}
149                      WHERE source = ? AND entity_id IN (${chunk.map(() => '?').join(',')})`,
150                args: [text(source), ...chunk.map(text)],
151            }]);
152            for (const row of res?.rows ?? []) {
153                seen++;
154                const [id, raw, ver, first, last] = row as [string, string, string, string, string];
155                if (Number(ver) !== schemaVer || Number(last) < cutoff) {
156                    recordCounters.stale++;
157                    continue;
158                }
159                try {
160                    found.set(id, { record: JSON.parse(raw) as T, schemaVer: Number(ver), firstSeen: Number(first), lastConfirmed: Number(last) });
161                } catch {
162                    recordCounters.errors++;
163                }
164            }
165        }
166        recordCounters.hits += found.size;
167        recordCounters.misses += unique.length - seen;
168    } catch {
169        recordCounters.errors++;
170        recordCounters.misses += unique.length - found.size;
171    }
172    return found;
173}
174
175/**
176 * Store records from a live fetch. Overwrites the record and schema, refreshes last_confirmed, and
177 * keeps first_seen. Never throws.
178 */
179export async function writeRecords(
180    source: string,
181    rows: { entityId: string; record: unknown }[],
182    schemaVer: number,
183): Promise<void> {
184    if (disabled || rows.length === 0) return;
185    const now = Date.now();
186    const stmts: Stmt[] = [];
187    for (const { entityId, record } of rows) {
188        if (!entityId) continue;
189        const json = JSON.stringify(record);
190        if (json.length > MAX_RECORD_BYTES) {
191            recordCounters.tooLarge++;
192            continue;
193        }
194        stmts.push({
195            sql: `INSERT INTO ${TABLE} (source, entity_id, record, schema_ver, first_seen, last_confirmed)
196                  VALUES (?, ?, ?, ?, ?, ?)
197                  ON CONFLICT(source, entity_id) DO UPDATE SET
198                    record = excluded.record, schema_ver = excluded.schema_ver, last_confirmed = excluded.last_confirmed`,
199            args: [text(source), text(entityId), text(json), int(schemaVer), int(now), int(now)],
200        });
201    }
202    if (stmts.length === 0) return;
203    try {
204        await ready();
205        await pipeline(stmts);
206        recordCounters.writes += stmts.length;
207    } catch {
208        recordCounters.errors++;
209    }
210}
211
212/**
213 * Field-level comparison of a stored record with a live one. Used in shadow mode to measure how often
214 * the data actually changes, which is what decides how long a stored record may be trusted.
215 * Returns the top-level keys whose JSON differs.
216 */
217export function changedFields(stored: unknown, live: unknown): string[] {
218    const a = (stored ?? {}) as Record<string, unknown>;
219    const b = (live ?? {}) as Record<string, unknown>;
220    const keys = new Set([...Object.keys(a), ...Object.keys(b)]);
221    const out: string[] = [];
222    for (const k of keys) if (JSON.stringify(a[k]) !== JSON.stringify(b[k])) out.push(k);
223    return out.sort();
224}
225
226/**
227 * Count that these ids were handed to a customer (from the store or freshly fetched). Feeds
228 * listRefreshCandidates. Never throws.
229 */
230export async function markServed(source: string, ids: string[]): Promise<void> {
231    const unique = [...new Set(ids.filter(Boolean))];
232    if (disabled || unique.length === 0) return;
233    try {
234        await ready();
235        const now = Date.now();
236        const stmts: Stmt[] = [];
237        for (let i = 0; i < unique.length; i += READ_CHUNK) {
238            const chunk = unique.slice(i, i + READ_CHUNK);
239            stmts.push({
240                sql: `UPDATE ${TABLE} SET serve_count = serve_count + 1, last_served = ?
241                      WHERE source = ? AND entity_id IN (${chunk.map(() => '?').join(',')})`,
242                args: [int(now), text(source), ...chunk.map(text)],
243            });
244        }
245        await pipeline(stmts);
246    } catch {
247        recordCounters.errors++;
248    }
249}
250
251/**
252 * Rows worth refreshing before they expire: confirmed between maxAgeMs and minAgeMs ago, handed
253 * out at least minServes times, the last time within servedWithinMs. Most-served first. Returns
254 * [] on any failure.
255 */
256export async function listRefreshCandidates(
257    source: string,
258    opts: { minAgeMs: number; maxAgeMs: number; minServes: number; servedWithinMs: number; limit: number },
259): Promise<string[]> {
260    if (disabled || opts.limit <= 0) return [];
261    try {
262        await ready();
263        const now = Date.now();
264        const [res] = await pipeline([{
265            sql: `SELECT entity_id FROM ${TABLE}
266                  WHERE source = ? AND last_confirmed BETWEEN ? AND ? AND serve_count >= ? AND last_served >= ?
267                  ORDER BY serve_count DESC, last_confirmed ASC LIMIT ?`,
268            args: [text(source), int(now - opts.maxAgeMs), int(now - opts.minAgeMs), int(opts.minServes), int(now - opts.servedWithinMs), int(opts.limit)],
269        }]);
270        return (res?.rows ?? []).map((r) => String(r[0]));
271    } catch {
272        recordCounters.errors++;
273        return [];
274    }
275}
276
277/** Delete rows not confirmed for olderThanMs. Returns how many went, or -1 on failure. */
278export async function purgeRecords(source: string, olderThanMs: number): Promise<number> {
279    if (disabled || olderThanMs <= 0) return 0;
280    try {
281        await ready();
282        const [, count] = await pipeline([
283            { sql: `DELETE FROM ${TABLE} WHERE source = ? AND last_confirmed < ?`, args: [text(source), int(Date.now() - olderThanMs)] },
284            { sql: 'SELECT changes()' },
285        ]);
286        return Number(count?.rows?.[0]?.[0] ?? 0);
287    } catch {
288        recordCounters.errors++;
289        return -1;
290    }
291}
292
293/**
294 * Point this process at another database (an actor whose volume should not share the default one).
295 * Call before the first read or write; the table is created there on first use.
296 */
297export function configureRecordStore(opts: { url: string; token: string }): void {
298    DB_URL = opts.url;
299    AUTH_TOKEN = opts.token;
300    schemaReady = null;
301}
302
303/** Turn the store off for this process (tests, or a run that must not touch it). */
304export function disableRecordStore(): void {
305    disabled = true;
306}

src/lib/residentialFallback.ts

1/**
2 * Residential proxy with an automatic fallback: Evomi first; while Evomi turns tunnels away,
3 * IPCook (flat rate, no per-GB bill) and then Apify RESIDENTIAL.
4 *
5 * Canonical copy lives in /Users/muhameddidovic/projects/shared-proxy-session/.
6 * EDIT IT THERE, then run ./sync-residential-fallback.sh. Never hand-edit an actor's copy.
7 *
8 * ── WHY
9 * On 2026-10-05 the Evomi balance ran out around 17:30 UTC, and Evomi answered every
10 * CONNECT with 402 Payment Required until a top-up around 19:40. Every actor that hardcodes
11 * Evomi failed for those two hours: 594 customer runs, 546 of them from 40 paying users
12 * (Glassdoor, Expedia, Cars, Craigslist, Truth Social, BizQuest, Instagram, Hotels ...).
13 * The same happened on 2026-10-14 02:20-04:30 UTC.
14 *
15 * ── USE
16 * Where an actor picks between our Evomi and something else, rename the call:
17 *     await Actor.createProxyConfiguration(proxyConfig)
18 *  -> await createProxyConfigurationWithFallback(proxyConfig, { forceFallback: input.debugForceProxyFallback === true })
19 * It only takes over when proxyConfig is our own single Evomi URL; a customer's proxy or
20 * Apify Proxy passes straight through. Where Evomi is the only option, call
21 * createResidentialProxyConfiguration() directly.
22 * Either result is an ordinary ProxyConfiguration: give it to a crawler, or call newUrl() /
23 * newProxyInfo() for got-scraping or impit, as before. `debugForceProxyFallback` is an
24 * input left out of the schema, for smoke runs that prove the fallback still works:
25 * `true` forces the first backup (IPCook where it applies), `"apify"` skips IPCook too.
26 *
27 * ── HOW
28 * residentialProbe.ts checks the primary with a CONNECT handshake when the configuration
29 * is created and every 60 s after (no page bytes). Each URL handed out follows the lane at
30 * that moment, so an actor that asks for a URL per request or per session moves within a
31 * minute; one that takes a single URL at startup keeps it for the run.
32 *
33 * Backup order while the primary fails:
34 *   1. IPCook, only when the run does not need a country (IPCook has a worldwide pool and
35 *      a Spanish one, nothing else) and the actor did not opt out with `ipcook: false`.
36 *      Its CONNECT is probed on the same timer; two failures in a row move on to 2.
37 *      IPCook exits sit 2-4 s further from most sites than Evomi's, and some sites refuse
38 *      them (AutoScout24 403'd 19 of 30 on 2026-10-14): opt such actors out.
39 *   2. Apify RESIDENTIAL in the primary's country, billed per GB to us. If the run's account
40 *      cannot use the RESIDENTIAL group, IPCook URLs are handed out instead, failing or not.
41 * Log lines never name a vendor: customers read the run log.
42 */
43import { Actor, type ProxyConfiguration } from 'apify';
44import { createHash } from 'node:crypto';
45import {
46    countryFromProxyUrl, isOwnEvomiConfig, type LaneState, nextLane, type ProbeResult, probeProxy, type ResidentialLane,
47} from './residentialProbe.js';
48
49export const EVOMI_URL = 'http://muhameddi0:qeCuRQMAN5oVKEnVSay9@core-residential.evomi.com:1000';
50
51// Nothing listens here. forceFallback puts it first, so the probe fails and the run
52// switches the way it would in a real outage.
53export const DEAD_PROXY_URL = 'http://127.0.0.1:9';
54
55const PROBE_INTERVAL_MS = 60_000;
56
57// Flat-rate plan. The username suffix is the zone: `-global` (worldwide) and `-es` (Spain)
58// are the only ones that authenticate; every other country answers 407 (checked 2026-09-18).
59const IPCOOK_USER = '8WFa6DlXSrSdTlVHaiXBR3V';
60const IPCOOK_PASS = 'M5OBrq5ySMyxjFOaxs';
61const IPCOOK_HOST = 'bw01.ipcook.com:2923';
62
63/** IPCook URL for a zone, pinned to one exit when a session id is given. */
64export function ipcookUrl(zone: 'global' | 'es', sessionId?: string | number): string {
65    // Session ids pin only as [a-z0-9_]{3,18}: a hyphen 407s, 20 chars silently rotates.
66    // A hash keeps distinct sessions distinct after folding.
67    const session = sessionId === undefined ? '' : `-session-s${createHash('sha1').update(String(sessionId)).digest('hex').slice(0, 11)}`;
68    return `http://${IPCOOK_USER}-${zone}${session}:${IPCOOK_PASS}@${IPCOOK_HOST}`;
69}
70
71/** The IPCook zone that can stand in for a country, or null when none can. */
72export function ipcookZoneFor(countryCode: string | undefined): 'global' | 'es' | null {
73    if (!countryCode) return 'global';
74    return countryCode.toUpperCase() === 'ES' ? 'es' : null;
75}
76
77export type ResidentialSource = 'primary' | 'ipcook' | 'apify';
78
79let currentLane: ResidentialLane = 'primary';
80let currentSource: ResidentialSource = 'primary';
81/** 'primary' while Evomi carries the run, 'fallback' while any backup does. For logs and telemetry. */
82export const residentialProxyLane = (): ResidentialLane => currentLane;
83/** Which backup carries the run right now ('primary' when none). For telemetry, never for customer logs. */
84export const residentialFallbackSource = (): ResidentialSource => currentSource;
85
86// Apify session ids allow [\w._~], up to 50 chars. Crawlee's own ids fit; others are folded.
87const toApifySessionId = (id: string | number | undefined) =>
88    id === undefined ? undefined : String(id).replace(/[^\w.~]/g, '_').slice(0, 50) || undefined;
89
90export async function createResidentialProxyConfiguration(opts: {
91    /** Primary proxy URL, e.g. an Evomi URL with a country in the password. */
92    primaryUrl?: string;
93    /** Country for the fallback, e.g. 'US'. Defaults to the primary URL's `_country-XX`, else any. */
94    countryCode?: string;
95    forceFallback?: boolean;
96    /** false keeps IPCook out of the backups, for sites that refuse its exits. */
97    ipcook?: boolean;
98    probeIntervalMs?: number;
99} = {}): Promise<ProxyConfiguration | undefined> {
100    const forced = await forcedLane(opts.forceFallback);
101    const primaryUrl = forced ? DEAD_PROXY_URL : (opts.primaryUrl ?? EVOMI_URL);
102    const countryCode = opts.countryCode ?? countryFromProxyUrl(opts.primaryUrl ?? EVOMI_URL);
103    const zone = opts.ipcook === false ? null : ipcookZoneFor(countryCode);
104    const ipcookFor = (sessionId?: string | number) => (forced === 'apify' ? DEAD_PROXY_URL : ipcookUrl(zone ?? 'global', sessionId));
105    let state: LaneState = { lane: 'primary', failStreak: 0 };
106    // IPCook is checked only while the primary fails. Assumed good until a probe says otherwise.
107    let ipcookFails = 0;
108
109    let fallback: Promise<ProxyConfiguration | undefined> | undefined;
110    const fallbackConfiguration = () => {
111        fallback ??= Actor.createProxyConfiguration({
112            groups: ['RESIDENTIAL'],
113            ...(countryCode ? { countryCode } : {}),
114        }).catch((err: Error) => {
115            console.warn(`[PROXY] second backup proxy unavailable (${err.message})`);
116            return undefined;
117        });
118        return fallback;
119    };
120
121    const sourceNow = (): ResidentialSource => {
122        if (state.lane === 'primary') return 'primary';
123        return zone && ipcookFails < 2 ? 'ipcook' : 'apify';
124    };
125    // Per configuration, so a run with one configuration per market logs each one's own moves.
126    let mySource = 'primary' as ResidentialSource;
127    const update = (reason?: string) => {
128        const before = mySource;
129        mySource = sourceNow();
130        currentLane = state.lane;
131        currentSource = mySource;
132        if (mySource === before) return;
133        if (mySource === 'primary') console.log('[PROXY] primary residential proxy recovered; leaving the backup');
134        else if (before === 'primary') console.log(`[PROXY] primary residential proxy failing (${reason ?? 'unknown'}); using the ${mySource === 'ipcook' ? 'first' : 'second'} backup until it recovers`);
135        else console.log(`[PROXY] ${mySource === 'apify' ? 'first backup failing; using the second backup' : 'first backup recovered; moving back to it'}`);
136    };
137
138    const check = async () => {
139        const result: ProbeResult = await probeProxy(primaryUrl);
140        state = nextLane(state, result);
141        if (state.lane === 'fallback' && zone) {
142            const ip = await probeProxy(ipcookFor());
143            ipcookFails = ip.ok ? 0 : ipcookFails + 1;
144        }
145        update(result.ok ? 'ok' : result.reason);
146    };
147
148    await check();
149    // One plain failure at startup is not enough to switch; check again now instead of
150    // sending the first minute of traffic through a proxy that may be down. The same goes
151    // for the first backup.
152    if (state.lane === 'primary' && state.failStreak > 0) await check();
153    if (state.lane === 'fallback' && ipcookFails === 1) await check();
154    if (mySource === 'apify') await fallbackConfiguration();
155
156    const timer = setInterval(() => {
157        check().catch(() => {});
158    }, opts.probeIntervalMs ?? PROBE_INTERVAL_MS);
159    timer.unref();
160
161    return Actor.createProxyConfiguration({
162        newUrlFunction: async (sessionId) => {
163            const source = sourceNow();
164            if (source === 'primary') return primaryUrl;
165            if (source === 'apify') {
166                const configuration = await fallbackConfiguration();
167                if (configuration) return (await configuration.newUrl(toApifySessionId(sessionId))) ?? primaryUrl;
168                // No RESIDENTIAL on this account: IPCook, even when its probe failed, beats a
169                // primary that is refusing every tunnel.
170                if (!zone) return primaryUrl;
171            }
172            return ipcookFor(sessionId);
173        },
174    });
175}
176
177/**
178 * Smoke-run switch. Actors pass `forceFallback: input.debugForceProxyFallback === true`; the
179 * string form `"apify"` never reaches them as true, so the input is read here as well.
180 */
181async function forcedLane(forceFallback: boolean | undefined): Promise<false | 'first' | 'apify'> {
182    let raw: unknown;
183    try {
184        raw = ((await Actor.getInput()) as { debugForceProxyFallback?: unknown } | null)?.debugForceProxyFallback;
185    } catch {
186        raw = undefined;
187    }
188    if (raw === 'apify') return 'apify';
189    return forceFallback || raw === true ? 'first' : false;
190}
191
192/**
193 * Drop-in for Actor.createProxyConfiguration(options): our own Evomi setup gets the
194 * fallback, anything else is created exactly as before.
195 */
196export async function createProxyConfigurationWithFallback(
197    options?: Parameters<typeof Actor.createProxyConfiguration>[0],
198    extra: { forceFallback?: boolean; ipcook?: boolean } = {},
199): Promise<ProxyConfiguration | undefined> {
200    if (isOwnEvomiConfig(options)) {
201        return createResidentialProxyConfiguration({ primaryUrl: options.proxyUrls[0], forceFallback: extra.forceFallback, ipcook: extra.ipcook });
202    }
203    return Actor.createProxyConfiguration(options);
204}

src/lib/residentialProbe.ts

1/**
2 * Health probe and lane decision for residentialFallback.ts. No dependencies beyond
3 * node:http, so it can be tested on its own against a fake proxy.
4 *
5 * Canonical copy lives in /Users/muhameddidovic/projects/shared-proxy-session/.
6 * EDIT IT THERE, then run ./sync-residential-fallback.sh. Never hand-edit an actor's copy.
7 */
8import http from 'node:http';
9
10export type ResidentialLane = 'primary' | 'fallback';
11export type ProbeResult = { ok: true } | { ok: false; status?: number; reason: string };
12export type LaneState = { lane: ResidentialLane; failStreak: number };
13
14// Any reachable HTTPS host does; the probe stops at the proxy's answer to CONNECT and
15// never sends a byte through the tunnel.
16const PROBE_TARGET = 'www.google.com:443';
17const PROBE_TIMEOUT_MS = 10_000;
18
19// The proxy turned the account away. Retrying cannot help until someone acts:
20// 402 is an empty balance (2026-10-05), 407 is rejected credentials.
21const ACCOUNT_REFUSALS = new Set([402, 407]);
22
23/**
24 * Opens one CONNECT tunnel through `proxyUrl` and closes it at once. Measures exactly the
25 * failure that took the portfolio down on 2026-10-05: the proxy answering CONNECT with
26 * something other than 200. Never rejects.
27 */
28export function probeProxy(proxyUrl: string, target = PROBE_TARGET, timeoutMs = PROBE_TIMEOUT_MS): Promise<ProbeResult> {
29    return new Promise((resolve) => {
30        let url: URL;
31        try {
32            url = new URL(proxyUrl);
33        } catch {
34            resolve({ ok: false, reason: 'unparseable proxy URL' });
35            return;
36        }
37        const headers: Record<string, string> = { host: target };
38        if (url.username) {
39            const credentials = `${decodeURIComponent(url.username)}:${decodeURIComponent(url.password)}`;
40            headers['proxy-authorization'] = `Basic ${Buffer.from(credentials).toString('base64')}`;
41        }
42        const req = http.request({
43            host: url.hostname,
44            port: Number(url.port || 80),
45            method: 'CONNECT',
46            path: target,
47            headers,
48            timeout: timeoutMs,
49        });
50        let settled = false;
51        const finish = (result: ProbeResult) => {
52            if (settled) return;
53            settled = true;
54            req.destroy();
55            resolve(result);
56        };
57        req.on('connect', (res, socket) => {
58            socket.destroy();
59            const status = res.statusCode ?? 0;
60            finish(status === 200 ? { ok: true } : { ok: false, status, reason: `proxy answered ${status} ${res.statusMessage ?? ''}`.trim() });
61        });
62        req.on('timeout', () => finish({ ok: false, reason: `no answer within ${timeoutMs / 1000}s` }));
63        req.on('error', (err: NodeJS.ErrnoException) => finish({ ok: false, reason: err.code ?? err.message }));
64        req.end();
65    });
66}
67
68/**
69 * An account refusal moves to the fallback at once. Any other failure needs two probes in
70 * a row, because a single residential tunnel can fail on its own. One good probe moves
71 * back: the primary is the cheaper lane.
72 */
73export function nextLane(state: LaneState, result: ProbeResult): LaneState {
74    if (result.ok) return { lane: 'primary', failStreak: 0 };
75    const failStreak = state.failStreak + 1;
76    if (result.status !== undefined && ACCOUNT_REFUSALS.has(result.status)) return { lane: 'fallback', failStreak };
77    return { lane: failStreak >= 2 ? 'fallback' : state.lane, failStreak };
78}
79
80/**
81 * The exit country an Evomi URL asks for (`_country-GB` in the password), so the fallback
82 * can ask Apify for the same one. Autotrader 403s any exit outside the UK.
83 */
84export function countryFromProxyUrl(proxyUrl: string): string | undefined {
85    try {
86        return decodeURIComponent(new URL(proxyUrl).password).match(/_country-([a-z]{2})(?:_|$)/i)?.[1]?.toUpperCase();
87    } catch {
88        return undefined;
89    }
90}
91
92const OWN_EVOMI_HOST = 'core-residential.evomi.com';
93const OWN_EVOMI_USER = 'muhameddi0';
94
95/**
96 * True when proxy options are our own hardcoded Evomi setup: Apify Proxy off and exactly
97 * one URL, on Evomi's host under our account. A customer's proxy, Apify Proxy, or a mixed
98 * list (ipcook + Evomi) is not, and keeps its existing behavior.
99 */
100export function isOwnEvomiConfig(options: unknown): options is { proxyUrls: [string] } {
101    const o = options as { useApifyProxy?: boolean; proxyUrls?: unknown } | undefined;
102    if (!o || o.useApifyProxy || !Array.isArray(o.proxyUrls) || o.proxyUrls.length !== 1) return false;
103    try {
104        const url = new URL(String(o.proxyUrls[0]));
105        return url.hostname === OWN_EVOMI_HOST && decodeURIComponent(url.username) === OWN_EVOMI_USER;
106    } catch {
107        return false;
108    }
109}

src/lib/runTelemetry.ts

1import { Actor, Dataset } from 'apify';
2import { format, inspect } from 'node:util';
3import { createHmac } from 'node:crypto';
4
5/**
6 * Run telemetry mirror → Axiom (axiom.co).
7 *
8 * Companion to failureAlertWebhook.ts. The webhook is the NOTIFICATION path
9 * (platform-side, survives OOM/SIGKILL/abort). This module is the FORENSICS
10 * path: customer runs execute in the customer's account, whose logs the actor
11 * owner cannot read via the Apify API - so the actor mirrors its own story to
12 * an Axiom dataset the owner controls:
13 *
14 *   run-start  - right after Actor.init(): runId, userId, build, memory, the
15 *                full (secret-redacted) input and the platform timeout
16 *                (extra.timeoutAt / extra.timeoutSecs).
17 *   heartbeat  - every 45 s: dataset item count, error/warn counts, the last
18 *                few error lines, RSS. For a hard-killed run the last
19 *                heartbeat IS the log tail.
20 *   migrating  - platform event, when the SDK gets to see it. Not an end: the
21 *                run carries on in a new container, which sends run-start again.
22 *   run-end    - one per run. The actor sends it on its own finish; this module
23 *                sends it for the ends the actor never reaches: status ABORTED
24 *                when the platform's `aborting` event arrives (a graceful
25 *                abort), TIMED-OUT a few seconds before the run's timeout (see
26 *                armTimeoutFlush), and ABORTED from the PLATFORM for an abort
27 *                that is not graceful (see registerAbortWebhook). A run with a
28 *                start event and no run-end died without warning: out of
29 *                memory or a crash.
30 *
31 * Dig-in flow: Telegram alert arrives → query Axiom by runId. APL:
32 *   ['actor-runs-v2'] | where runId == "..." | sort by _time asc
33 *
34 * The console capture also decides what a CUSTOMER's run prints: lines naming
35 * the plumbing or a paid vendor are recorded here but kept off the customer's
36 * screen. See customerView().
37 *
38 * THE COLUMN CEILING - read before adding a field.
39 *
40 * An Axiom dataset holds 256 columns and slots are never reclaimed while data
41 * is retained: a field an actor writes once keeps its column. The predecessor
42 * dataset ['actor-runs'] died of exactly that on 2026-09-05 - 231 of its 256
43 * columns were per-actor one-off names (114 written by a single actor), and
44 * once full, Axiom refused any event carrying a NEW top-level name. It refuses
45 * the record WHOLE: the run-end was not trimmed, it was discarded, so an actor
46 * silently vanished from the zero-item sweep and every run-end dashboard,
47 * leaving one warning line in a log nobody reads. This dataset is the rotation
48 * away from it; ['actor-runs'] keeps history until its retention runs out on
49 * 2026-10-05 and is read-only from here.
50 *
51 * So: DO NOT INVENT TOP-LEVEL FIELD NAMES. Pass whatever you like to
52 * finishRunTelemetry's `extra` - routeFields() nests anything not in
53 * TOP_LEVEL_FIELDS under the `extra` map field, and a map field's keys cost no
54 * columns at all (four keys, one of them a nested object, measured as exactly
55 * one column). Query them with dot notation, exactly like a column:
56 *   ['actor-runs-v2'] | where extra.skippedIncremental > 0
57 *
58 * Promoting a key to a real column is a portfolio-wide decision (it spends a
59 * slot that is not returned while the data is retained), so add it to
60 * TOP_LEVEL_FIELDS here, in the canonical file, never in an actor's copy.
61 *
62 * Everything here is fire-and-forget and exception-proof: telemetry must
63 * never slow down, crash, or keep alive a customer run. The ingest token is
64 * hardcoded on purpose (see global rules - env vars silently break customer
65 * runs); an Axiom ingest-only token can only APPEND to this one dataset,
66 * never read or administer, so a leak is low-stakes.
67 */
68const AXIOM_TOKEN = 'xaat-b91bfae7-5d57-49fa-8633-79b53209637c';
69const AXIOM_DATASET = 'actor-runs-v2';
70// Regional edge ingest endpoint for this account (classic
71// api.axiom.co/v1/datasets/<ds>/ingest also works; edge is lower-latency).
72const AXIOM_INGEST_URL = `https://us-east-1.aws.edge.axiom.co/v1/ingest/${AXIOM_DATASET}`;
73// The map field that absorbs every per-actor field. Declared on the dataset
74// with POST /v2/datasets/actor-runs-v2/mapfields {"name":"extra"} - it MUST
75// exist there before this module ships, or Axiom flattens the object back into
76// one column per key and the ceiling problem returns. A dataset rotation is not
77// complete until that call has been made. See THE COLUMN CEILING above.
78const MAP_FIELD = 'extra';
79
80const HEARTBEAT_MS = 45_000;
81// How long a run-end waits for the platform to drop the abort webhook (see
82// registerAbortWebhook) before it gives up and lets the run end.
83const ABORT_WEBHOOK_DROP_MS = 2_000;
84// A run that hits its timeout is SIGKILLed at ACTOR_TIMEOUT_AT with no event
85// first, so its run-end goes out this long before. Up to 2026-10-06 such runs
86// sent none: realestate-au-listings had 134 start-only runs in a week from one
87// customer whose runs time out at 60 s. Kept short, because a run that would
88// have finished inside this window is reported TIMED-OUT all the same; the
89// fleet's own soft deadlines stop 7.5 s or more before the timeout.
90const PRE_TIMEOUT_LEAD_MS = 5_000;
91// An abort or timeout run-end races the kill, so it waits this long for the
92// platform item count and then goes without it (itemCount null = unknown).
93const LAST_GASP_COUNT_MS = 1_500;
94// Re-reads of the platform's dataset counter at run-end while it still reads below
95// the in-process push counter. Only runs on a finished run whose counter is provably
96// behind, and stops the moment it catches up; a single 1.5 s wait was not enough
97// (crexi WlLkmmLGfSTuptTDj still read 0 after it).
98const COUNT_SETTLE_MS = [1_500, 2_500];
99// setTimeout runs the callback at once when the delay is longer than this
100// (~24.8 days), which would send TIMED-OUT the moment a long run started.
101const MAX_TIMER_MS = 2_147_483_647;
102// Error lines are kept 25 deep but heartbeats only ship the newest 8: a heartbeat
103// fires every 45 s on every run in the fleet, while run-end fires once, so the
104// deep tail rides the cheap event. Raised from a flat 8 on 2026-08-25 - a digest
105// sweep of 147 customer failures found the reason was in run-end lastErrors for
106// 111 of them, so this is the field the diagnosis actually comes out of.
107const MAX_KEPT_ERROR_LINES = 25;
108const HEARTBEAT_ERROR_LINES = 8;
109const MAX_ERROR_LINE_CHARS = 400;
110// A plain narration tail, so a run that dies WITHOUT ever calling console.error
111// still leaves a trail. Owners cannot read customer run logs at all, so without
112// this such a failure reports no reason anywhere.
113const MAX_KEPT_LOG_LINES = 12;
114const MAX_LOG_LINE_CHARS = 200;
115// run-start's `input` is often the only copy of a customer's input the owner can
116// read: Apify answers 404 when the owner fetches a customer run. Until 2026-09-25
117// the cap was 4000 chars, and it cut 8,822 of 645,320 run-starts (Sep 6-25). A
118// hiring.cafe customer sent ~22 search URLs of ~3,600 chars each, and only the
119// first one arrived.
120//
121// Axiom's limits, probed on actor-runs-v2 on 2026-09-25: a string field over
122// 1 MiB is stored as `<invalid string: too long>` (the value is lost, the event
123// kept), and a RECORD of 1 MiB (1,048,576 bytes) or more is refused whole with a
124// 400, so the run-start is gone. The cap counts UTF-16 units, and one unit is at
125// most 3 UTF-8 bytes, so 256K units is at most 768 KiB, which leaves ~256 KiB for
126// the rest of the record (a 786,432-byte probe was stored intact). An input over
127// the cap is cut here, where the cut is marked, instead of by Axiom.
128//
129// `input` stays a JSON string, never an object: as an object, every input key
130// would become a column (see THE COLUMN CEILING above).
131const MAX_INPUT_JSON_CHARS = 256 * 1024;
132
133// Key names whose value is a credential, at any depth, array items included.
134// `webhook` joined on 2026-09-25: whoever holds a Slack or Discord incoming-webhook URL
135// can post to that channel, and keys like `webhookUrl` or `slackWebhookUrl` matched none
136// of the others. `session`, `auth`, `credential`, `jwt`, `csrf` and `li_at` joined on
137// 2026-10-23 (see redactSecrets). `auth` skips `author…`/`authority`, so a search field
138// such as `authorName` stays readable; `authorization` has its own entry.
139const SENSITIVE_KEY_RE = /token|secret|password|passwd|api[-_]?key|cookie|bearer|authorization|auth(?!or)|session|credential|jwt|csrf|xsrf|private[-_]?key|access[-_]?key|webhook|(?:^|[^a-z])li_?at(?:$|[^a-z])/i;
140
141// Cookie names that ARE a login: a `{name, value}` pair under one of these names has its
142// value redacted, and so does `name=value` in a string. Matched on the whole name.
143const SESSION_COOKIE_NAME_RE = /^(?:li_at|li_a|li_rm|liap|li_mc|jsessionid|bcookie|bscookie|lidc|sessionid|session_id|sessid|phpsessid|connect\.sid|sid|ssid|hsid|apisid|sapisid|csrftoken|csrf_token|_csrf|xsrf-token|ds_user_id|c_user|xs|fr|datr|auth_token|ct0|twid|kdt|cf_clearance|__cf_bm|_abck|bm_sz|ak_bmsc|datadome|_px\w*|web_session|a1|at-main|sess-at-main|session-token|x-main|__secure-.+|__host-.+|_session.*|.*_session|.*sess(?:ion)?id.*|.*(?:auth(?!or)|token|csrf|xsrf).*)$/i;
144
145// The same names as they appear in a Cookie header or a pasted cookie string. Value of 4+
146// characters that is not already masked, so the pass is idempotent.
147const SESSION_COOKIE_PAIR_RE = /(?<![A-Za-z0-9_.-])(li_at|li_rm|liap|JSESSIONID|bcookie|bscookie|lidc|sessionid|session_id|PHPSESSID|connect\.sid|csrftoken|ds_user_id|c_user|xs|datr|auth_token|ct0|twid|cf_clearance|__cf_bm|_abck|bm_sz|datadome|web_session|at-main|sess-at-main|session-token|x-main|__Secure-[A-Za-z0-9_.-]+|__Host-[A-Za-z0-9_.-]+|_session[A-Za-z0-9_]*|[A-Za-z0-9]+_session)=(?!\*\*\*)(?:"[^"]{4,}"|[^\s;"',&]{4,})/gi;
148
149// A whole string that is a cookie header: two or more `name=value` pairs joined by `;`.
150const COOKIE_HEADER_RE = /^\s*(?:cookie:\s*)?[^\s=;,]+=[^;]*(?:;\s*[^\s=;,]+=[^;]*){1,}\s*;?\s*$/i;
151
152// Cookie attributes: an object that carries `name` and `value` plus one of these is a
153// browser-exported cookie, whatever its name.
154const COOKIE_ATTR_KEYS = ['domain', 'path', 'httpOnly', 'secure', 'expirationDate', 'expires', 'sameSite', 'hostOnly', 'session', 'storeId'];
155
156// The walk is bounded: depth, total nodes and per-string length. Input is cut at
157// MAX_INPUT_JSON_CHARS after this anyway, so a string longer than that is cut here first
158// and the regexes never see more than it.
159const REDACT_MAX_DEPTH = 20;
160const REDACT_MAX_NODES = 20_000;
161const REDACT_MAX_STRING = MAX_INPUT_JSON_CHARS;
162
163const REDACTED = '<redacted>';
164
165// Settings that share a word with a credential key and carry no secret: `useSessionPool:
166// true`, `maxSessions: 20`, `maxTokens: 500`. Booleans and null always stay; a number
167// stays only under a count-like key, so `password: 1234` still goes.
168const COUNT_KEY_RE = /^(?:max|min|num|use)(?:[A-Z_-]|$)|(?:count|size|limit|timeout|secs?|ms|retries|rotations|pages|age)$/i;
169function keepUnderSensitiveKey(k: string, x: unknown): boolean {
170    if (x == null || typeof x === 'boolean') return true;
171    return typeof x === 'number' && COUNT_KEY_RE.test(k);
172}
173
174/** A string value in the input with its credentials masked. */
175function redactInputString(s: string): string {
176    if (s.length > REDACT_MAX_STRING) s = `${s.slice(0, REDACT_MAX_STRING)}…(truncated)`;
177    // A pasted cookie header (`li_at=…; JSESSIONID=…`) goes whole: every pair in it is
178    // part of the login. A URL never matches (`;` pairs need no `/` or `?` before them,
179    // and a URL with `;` still has no space-free `name=value;name=value` from its start).
180    if (s.includes('=') && s.includes(';') && !/^[a-z][a-z0-9+.-]*:\/\//i.test(s) && COOKIE_HEADER_RE.test(s)) return REDACTED;
181    return redactText(s);
182}
183
184/**
185 * The run's input with its credentials masked, for run-start.
186 *
187 * Until 2026-10-23 this went by key name alone, so a credential under a key that named
188 * nothing went through. A customer of linkedin-company-people-scraper pasted a browser
189 * cookie export into the input root, which made keys `"0"`, `"1"` holding
190 * `{"name":"li_at","value":"…"}` and `{"name":"JSESSIONID","value":"…"}`, and both
191 * reached Axiom in clear (runs AHZZa38ExRe4yV3YA, WeMGMoloDeppSpRMe). Now, at any depth:
192 *  - a key named like a credential (SENSITIVE_KEY_RE) has its value replaced, unless the
193 *    value is a boolean or null, or a number under a count-like key (`maxSessions: 20`);
194 *  - an object holding `name`/`key` and `value` has the value replaced when the name is
195 *    a login cookie or a credential header (`Authorization`, `Cookie`), or when the
196 *    object also carries cookie attributes (`domain`, `httpOnly`, …);
197 *  - every string loses a cookie header, `li_at=…`-style pairs, bearer tokens, JWTs,
198 *    `key=value` credentials (redactText) and URL passwords and webhook paths.
199 * Names stay, so "the li_at cookie was given" is still readable in run-start.
200 */
201export function redactSecrets(obj: unknown): unknown {
202    let nodes = 0;
203    const walk = (v: unknown, depth: number): unknown => {
204        if (v == null || typeof v === 'boolean' || typeof v === 'number') return v;
205        if (++nodes > REDACT_MAX_NODES || depth > REDACT_MAX_DEPTH) return '<truncated>';
206        if (typeof v === 'string') return redactInputString(v);
207        if (Array.isArray(v)) return v.map((x) => walk(x, depth + 1));
208        if (typeof v !== 'object') return v;
209        const o = v as Record<string, unknown>;
210        const pairName = typeof o.name === 'string' ? o.name : typeof o.key === 'string' ? o.key : null;
211        const isSecretPair = 'value' in o && pairName != null
212            && (SESSION_COOKIE_NAME_RE.test(pairName) || SENSITIVE_KEY_RE.test(pairName)
213                || COOKIE_ATTR_KEYS.some((a) => a in o));
214        const out: Record<string, unknown> = {};
215        for (const [k, x] of Object.entries(o)) {
216            if (isSecretPair && k === 'value') out[k] = x == null || x === '' ? x : REDACTED;
217            else if (isSecretPair && (k === 'name' || k === 'key')) out[k] = x;
218            else if (SENSITIVE_KEY_RE.test(k) && !keepUnderSensitiveKey(k, x)) out[k] = REDACTED;
219            // The whole userinfo, up to the LAST '@'. Until 2026-09-25 this stopped at the
220            // first one, so a raw '@' in the password (`http://user:p@ss@host:8000`) left
221            // `ss@host:8000` readable in run-start.
222            else if (k === 'proxyUrls' && Array.isArray(x))
223                out[k] = x.map((u: any) => (typeof u === 'string' ? redactInputString(u.replace(/:\/\/.*@/, '://***:***@')) : walk(u, depth + 1)));
224            else out[k] = walk(x, depth + 1);
225        }
226        return out;
227    };
228    try { return walk(obj, 0); } catch { return '(input redaction failed)'; }
229}
230
231/**
232 * The credentials a URL carries by itself, wherever it sits: a password in the
233 * userinfo, and the path of an incoming-webhook URL (whoever holds one can post to
234 * that channel). Used by redactText on free text and by redactSecrets on every
235 * string in the input.
236 *
237 * The password runs to the LAST '@' before whitespace or a quote. It used to stop
238 * at the first, so `http://user:p@ss@host:8000` kept `ss@host:8000` readable. A
239 * password holding a quote falls back to the first '@', which is what the rule
240 * did before.
241 */
242function redactUrlSecrets(s: string): string {
243    return s
244        .replace(/(:\/\/[^:\s/]+):(?:[^\s"']*@|[^@\s]+@)/g, '$1:***@')
245        .replace(/(hooks\.slack\.com\/(?:services|workflows|triggers)\/|discord(?:app)?\.com\/api\/webhooks\/|webhook\.office\.com\/webhookb2\/)[^\s"'<>]+/gi, '$1***');
246}
247
248/**
249 * Redact credentials embedded in FREE TEXT. `redactSecrets` above walks an
250 * object and censors by KEY NAME, which does nothing for a credential sitting
251 * inside a sentence - and that is the shape that actually escapes: a transport
252 * error quotes the proxy URL with its password
253 * ("Proxy responded with 407 ... http://user:<password>@host:port").
254 *
255 * Applied to three sinks that reach outside the run: the captured console tail,
256 * the run-end telemetry fields, and the run's statusMessage (which the CUSTOMER
257 * sees, and which the failure webhook forwards to Telegram verbatim via the
258 * platform's {{resource.statusMessage}} template). Before 2026-09-02 none of
259 * them were covered: trulia-scraper wrote a stale residential proxy password
260 * into statusMessage on all 163 of its failed runs that way. Since 2026-10-23
261 * it also masks a credential in a console line a customer's run prints (see
262 * customerView).
263 *
264 * Idempotent - running it twice over the same string changes nothing, so double
265 * application through overlapping paths is harmless.
266 */
267export function redactText(s: string): string {
268    // eslint-disable-next-line no-control-regex
269    return redactUrlSecrets(s.replace(/\u001b\[[0-9;]*[A-Za-z]/g, ''))
270        // `token` is also an ordinary English word, and both of the rules below used to
271        // eat it. A buyer's run reported `Unexpected token *** shape`: the real text was
272        // `Unexpected token response shape` - "response" is exactly 8 characters, so it
273        // cleared the {8,} bar - and the stack frame `at fetchToken (file:///…get-token.js:73:15)`
274        // became `at fetchToken ***`, because the key rule accepted a bare space as an
275        // assignment and matched the "Token" inside "fetchToken". Redaction that destroys
276        // the one byte naming the fault (a `<` says HTML came back instead of JSON) costs
277        // more than it protects, and it is synced to 200+ actors.
278        //
279        // Two discriminators, both measured against the credential shapes we actually leak:
280        // a value following bearer/basic/token must look like a credential - carry a digit,
281        // or be 20+ characters - and a key must be followed by a real assignment, or by
282        // whitespace and a value that passes that same test, never by prose (the two key
283        // rules below).
284        .replace(
285            /\b(bearer|basic|token)\s+(?=[A-Za-z0-9._\-~+/=]*[0-9])[A-Za-z0-9._\-~+/=]{8,}|\b(bearer|basic|token)\s+[A-Za-z0-9._\-~+/=]{20,}/gi,
286            (m) => m.replace(/\s+.*/, ' ***'),
287        )
288        .replace(/\beyJ[A-Za-z0-9._-]{10,}/g, '***')
289        // Key rule. Until 2026-09-25 the other key names still took a bare space or a lone
290        // quote as the assignment, so customers read `Facebook served a cookie *** for the
291        // search "Lubin".` and `the search "Secret ***"` in their status message, and so did
292        // Telegram. `token` had its own rule, which still took a lone quote
293        // (`the "token" *** is missing`). Every key now needs `:` or `=`, with quotes, spaces
294        // or a JSON escape allowed on either side of it: `password=…`, `"password": "…"`,
295        // `{\"password\":\"…\"}`, `Cookie: …`, `x-api-key: …`, `?api_key=…&`.
296        // An auth scheme after the assignment stays and the credential after it goes:
297        // `Authorization: Bearer xyz` used to come out as `*** xyz`, and
298        // `Proxy-Authorization: Basic <base64 user:pass>` kept the base64. A value ending in
299        // `;` carries on through `; name=value` pairs, so every cookie in a Cookie header is
300        // covered, not just the first.
301        .replace(
302            /(?<![A-Za-z0-9])((?:x-)?(?:api[-_]?key|access[-_]?token|auth[-_]?token|password|passwd|secret|authorization|auth|cookie|session[-_]?id|bearer|token)\\?["']?\s*[:=]\s*\\?["']?(?:(?:bearer|basic|digest|token)\s+)?)[^\s"',&]+(?:(?<=;)\s+[^\s"',&=]+=[^\s"',&]*)*/gi,
303            '$1***',
304        )
305        // Key rule, spaced form: the same key names with only whitespace (and quotes) before
306        // the value. The rule above left `password hunter2xyz9` and `cookie web_session=abc123;
307        // a1=xyz` whole, so here the value counts when it looks like a credential, by the test
308        // the bearer/basic/token rule uses: a digit and 8+ characters, or 20+ characters.
309        // Prose stays: `no cookie needed.`, `web_session cookie - Xiaohongshu gates…`,
310        // `cookie for IDs`, `password is wrong`, `the "token" is missing`. Only the
311        // credential-shaped run goes, so a trailing `.` or `!` stays; when `;` and more
312        // `name=value` pairs follow it, as in a Cookie header, they go too.
313        .replace(
314            /(?<![A-Za-z0-9])((?:x-)?(?:api[-_]?key|access[-_]?token|auth[-_]?token|password|passwd|secret|authorization|auth|cookie|session[-_]?id|bearer|token)\\?["']?\s+\\?["']?(?:(?:bearer|basic|digest|token)\s+)?)(?:(?=[A-Za-z0-9._\-~+/=]*[0-9])[A-Za-z0-9._\-~+/=]{8,}|[A-Za-z0-9._\-~+/=]{20,})(?:;(?:\s+[^\s"',&=]+=[^\s"',&]*)+)?/gi,
315            '$1***',
316        )
317        // Login cookies by name, wherever they sit: `li_at=…`, `JSESSIONID="ajax:…"`,
318        // `sessionid=…` in a pasted cookie string with no `Cookie:` in front of it
319        // (added 2026-10-23, see redactSecrets).
320        .replace(SESSION_COOKIE_PAIR_RE, '$1=***');
321}
322
323interface TelemetryState {
324    brand: string;
325    startedAtMs: number;
326    // `any`, not NodeJS.Timeout: consumer actors' tsconfigs differ (some pull
327    // DOM typings where setInterval returns number) - this module must compile
328    // verbatim in every one of them.
329    heartbeatTimer: any;
330    errorCount: number;
331    warnCount: number;
332    lastErrors: string[];
333    // Narration tail: warn/log/info lines, kept separate from lastErrors so the
334    // error tail never gets crowded out by ordinary progress output.
335    lastLog: string[];
336    ingestFailures: number;
337    endSent: boolean;
338    // The run-end send in flight, so a second caller waits for it: the SDK's own
339    // exit on `aborting` must not kill the process under a run-end the actor
340    // started a moment earlier.
341    endPromise: Promise<void> | null;
342    // The pre-timeout flush (armTimeoutFlush). `any` for the same reason as
343    // heartbeatTimer.
344    timeoutTimer: any;
345    // Set by the `migrating` event: this container is going away, the run is not
346    // ending, and the next container arms its own timeout flush.
347    migrating: boolean;
348    // The platform-side ABORTED run-end (registerAbortWebhook): resolves to the
349    // webhook's id, or null when none was registered. Dropped once this process
350    // has sent a run-end of its own, so a run never gets two.
351    abortWebhook: Promise<string | null> | null;
352    // Counted in-process by patching Dataset.prototype.pushData -
353    // the platform's dataset itemCount is eventually consistent and reads 0
354    // for many seconds after a push (seen on run QFykc6btz00nJTNPd: 15 items
355    // pushed, getInfo() said 0 even 7s in). This counter is the authoritative
356    // itemsPushed; the laggy platform view is still reported as itemCount.
357    // Only pushes that resolved count: a push the platform refused is in rejectedCount.
358    pushedCount: number;
359    // Items in pushes that threw, e.g. "Schema validation failed" when a dataset schema
360    // refuses a row. Before 2026-10-09 they were counted in itemsPushed, so a run that saved
361    // 3 of 10 rows reported 10 (social-profile-finder, run bntcbj9aFT3FdPRCI).
362    rejectedCount: number;
363    // Rows that landed but carry an error instead of data ({error: 'no_results', ...},
364    // {success: false}), by the same rule as runGuard's isErrorRow. They stay in itemsPushed
365    // (they are real dataset rows) and come off itemsProduced. Before 2026-10-12 they counted
366    // as produced: a Facebook pages run with 2 pages and 6 no_results rows reported 8.
367    errorRowCount: number;
368    // Did the pushData patch actually take? Reported on every event so a run
369    // whose itemsPushed is 0 can be read correctly: pushCounterLive=true means
370    // "counted, and nothing was pushed"; false means "not counted at all, fall
371    // back to itemCount". Before 2026-07-30 the patch silently failed on every
372    // actor without the `crawlee` meta-package and there was no way to tell.
373    pushCounterLive: boolean;
374
375    // id of the run's DEFAULT dataset, resolved once at init. The push counter only
376    // counts pushes to this dataset - see installPushCounter. null when it could not
377    // be resolved, which makes the counter fall back to counting every dataset.
378    defaultDatasetId: string | null;
379}
380
381let state: TelemetryState | null = null;
382
383function tokenConfigured(): boolean {
384    return AXIOM_TOKEN.startsWith('xaat-') && !AXIOM_TOKEN.includes('REPLACE');
385}
386
387function baseFields(): Record<string, unknown> {
388    const env = process.env;
389    return {
390        brand: state?.brand,
391        actorId: env.ACTOR_ID || env.APIFY_ACTOR_ID || null,
392        actorName: env.ACTOR_FULL_NAME || env.ACTOR_ID || null,
393        buildNumber: env.ACTOR_BUILD_NUMBER || null,
394        runId: env.ACTOR_RUN_ID || env.APIFY_ACTOR_RUN_ID || 'local',
395        runUrl: env.ACTOR_RUN_ID && env.ACTOR_ID
396            ? `https://console.apify.com/actors/${env.ACTOR_ID}/runs/${env.ACTOR_RUN_ID}`
397            : null,
398        userId: env.APIFY_USER_ID || null,
399        userIsPaying: env.APIFY_USER_IS_PAYING === '1',
400        memoryMB: Number(env.ACTOR_MEMORY_MBYTES || 0) || null,
401        // Charge budget for this run. A tiny/zero budget clamps maxItems to 0,
402        // which produces a short, error-free, zero-item run that LOOKS like a
403        // failure but is just an exhausted-budget no-op - these fields let such
404        // runs self-identify (0-item + maxTotalChargeUsd near 0 = budget clamp).
405        maxTotalChargeUsd: Number(env.ACTOR_MAX_TOTAL_CHARGE_USD || 0) || null,
406        maxPaidDatasetItems: Number(env.ACTOR_MAX_PAID_DATASET_ITEMS || 0) || null,
407        platform: Boolean(env.ACTOR_RUN_ID || env.APIFY_ACTOR_RUN_ID),
408        elapsedSec: state ? Math.round((Date.now() - state.startedAtMs) / 1000) : 0,
409    };
410}
411
412/**
413 * Fields allowed to occupy their OWN column in the dataset. Anything else a
414 * caller passes rides inside the `extra` map field - see THE COLUMN CEILING in
415 * the file header. Treat this list as closed: every name added here spends one
416 * of a fixed, unreclaimable 256 slots shared by the whole portfolio.
417 */
418const TOP_LEVEL_FIELDS = new Set([
419    '_time',
420    // identity + environment (baseFields)
421    'event', 'brand', 'actorId', 'actorName', 'buildNumber', 'runId', 'runUrl',
422    'userId', 'userIsPaying', 'memoryMB', 'maxTotalChargeUsd', 'maxPaidDatasetItems',
423    'platform', 'elapsedSec',
424    // progress + health (heartbeatFields)
425    'itemsPushed', 'itemCount', 'itemsProduced', 'pushCounterLive',
426    'errorCount', 'warnCount', 'lastErrors', 'lastLog', 'rssMB',
427    // per-event
428    'input', 'status',
429    // cross-actor diagnosis fields the portfolio tooling queries BY NAME
430    // (zero-rate-check.mjs, portfolio-digest.cjs, axiom-runs.mjs). These stay
431    // top-level precisely so those queries keep working unchanged.
432    'zeroReason', 'zeroDetail', 'zeroLegit', 'errorMessage', 'failureReason', 'failClass',
433]);
434
435/**
436 * Route a flat event into the shape the dataset can actually accept: known
437 * names stay top-level, everything else is nested under the `extra` map field,
438 * whose keys cost no columns. An actor adding `extra.skippedIncremental` is
439 * free; adding a top-level `skippedIncremental` is what broke ingest.
440 */
441function routeFields(fields: Record<string, unknown>): Record<string, unknown> {
442    const top: Record<string, unknown> = {};
443    const overflow: Record<string, unknown> = {};
444    for (const [k, v] of Object.entries(fields)) {
445        if (TOP_LEVEL_FIELDS.has(k)) top[k] = v;
446        else overflow[k] = v;
447    }
448    if (Object.keys(overflow).length) top[MAP_FIELD] = overflow;
449    return top;
450}
451
452/**
453 * Extra field sources registered by higher-level modules (e.g. the unblocker
454 * chain's provider counters). Kept as getters so the values are current at emit
455 * time; each must be cheap and exception-proof. Their keys are NOT in
456 * TOP_LEVEL_FIELDS, so they ride inside the `extra` map at zero column cost and
457 * attach to EVERY event - heartbeat, aborting, migrating and run-end - so even a
458 * hard-killed run's last heartbeat carries them. Registration is via a
459 * module-load side effect (the source module imports this one), which keeps
460 * runTelemetry a leaf and needs no wiring at the finish call sites.
461 */
462const extraSources: Array<() => Record<string, unknown>> = [];
463export function registerTelemetrySource(fn: () => Record<string, unknown>): void {
464    extraSources.push(fn);
465}
466function collectExtraSources(): Record<string, unknown> {
467    const out: Record<string, unknown> = {};
468    for (const fn of extraSources) {
469        try { Object.assign(out, fn()); } catch { /* telemetry must never throw */ }
470    }
471    return out;
472}
473
474/** A 400 that means "this field would create a column and the dataset is full". */
475function isColumnLimitRejection(status: number, body: string): boolean {
476    return status === 400 && /column limit/i.test(body);
477}
478
479/**
480 * One ingest POST, resolved to a plain outcome. The response BODY is read on
481 * failure - Axiom names the offending field there, and without it a rejection
482 * is indistinguishable from any other 400.
483 */
484function post(fetchFn: any, record: Record<string, unknown>): Promise<{ ok: boolean; status: number; body: string }> {
485    const signal = typeof (AbortSignal as any)?.timeout === 'function' ? (AbortSignal as any).timeout(8000) : undefined;
486    return fetchFn(AXIOM_INGEST_URL, {
487        method: 'POST',
488        headers: { Authorization: `Bearer ${AXIOM_TOKEN}`, 'Content-Type': 'application/json' },
489        body: JSON.stringify([record]),
490        signal,
491    }).then((res: any) => {
492        if (res.ok) return { ok: true, status: res.status, body: '' };
493        return res.text().then(
494            (t: string) => ({ ok: false, status: res.status, body: String(t).slice(0, 300) }),
495            () => ({ ok: false, status: res.status, body: '' }),
496        );
497    });
498}
499
500/**
501 * Failures are noisy in aggregate - a heartbeat fires every 45 s - so only the
502 * first one per run is printed. run-end is exempt: it fires once, it is the
503 * event the portfolio zero-item sweep reads, and a silent loss of it is exactly
504 * the failure this logging exists to make visible.
505 */
506function reportIngestFailure(event: string, message: string): void {
507    if (!state) return;
508    const first = state.ingestFailures++ === 0;
509    if (!first && event !== 'run-end') return;
510    console.warn(`${message}${first && event !== 'run-end' ? ' (further failures silent)' : ''}`);
511}
512
513/**
514 * POST one event to Axiom. Never throws (even synchronously), never rejects,
515 * never keeps the process alive. Resolves true when Axiom stored the event. Global fetch is reached via globalThis so the
516 * module compiles without DOM typings AND degrades to a no-op on any old
517 * actor image whose Node predates global fetch (<18).
518 *
519 * Axiom rejects a record WHOLE: one unacceptable field and the entire event is
520 * discarded, not trimmed. So a column-limit rejection is retried once with the
521 * map field shed - a run-end stripped of its diagnostics still tells the sweep
522 * the run happened, which a dropped one does not.
523 */
524function send(event: string, fields: Record<string, unknown>): Promise<boolean> {
525    try {
526        const fetchFn: any = (globalThis as any).fetch;
527        if (!tokenConfigured() || typeof fetchFn !== 'function') return Promise.resolve(false);
528        const record = routeFields({ _time: new Date().toISOString(), event, ...baseFields(), ...collectExtraSources(), ...fields });
529        return post(fetchFn, record).then(
530            (r): boolean | Promise<boolean> => {
531                if (r.ok) return true;
532                if (isColumnLimitRejection(r.status, r.body) && record[MAP_FIELD]) {
533                    const dropped = Object.keys(record[MAP_FIELD] as Record<string, unknown>).join(', ');
534                    const bare = { ...record };
535                    delete bare[MAP_FIELD];
536                    return post(fetchFn, bare).then(
537                        (r2) => {
538                            if (r2.ok) {
539                                reportIngestFailure(event, `[TELEMETRY] Axiom refused the '${MAP_FIELD}' field (${r.body.trim()}) - '${event}' was RESENT WITHOUT IT; detail lost: ${dropped}`);
540                                return true;
541                            }
542                            reportIngestFailure(event, `[TELEMETRY] Axiom ingest HTTP ${r2.status} - '${event}' RECORD DROPPED ENTIRELY, nothing was stored: ${r2.body.trim()}`);
543                            return false;
544                        },
545                        (err2: any) => {
546                            reportIngestFailure(event, `[TELEMETRY] Axiom retry failed - '${event}' RECORD DROPPED ENTIRELY: ${(err2 as Error).message}`);
547                            return false;
548                        },
549                    );
550                }
551                reportIngestFailure(event, `[TELEMETRY] Axiom ingest HTTP ${r.status} - '${event}' RECORD DROPPED ENTIRELY, nothing was stored: ${r.body.trim()}`);
552                return false;
553            },
554            (err: any) => {
555                reportIngestFailure(event, `[TELEMETRY] Axiom ingest failed - '${event}' RECORD DROPPED ENTIRELY: ${(err as Error).message}`);
556                return false;
557            },
558        );
559    } catch {
560        return Promise.resolve(false);
561    }
562}
563
564/**
565 * What a CUSTOMER's run prints.
566 *
567 * A customer run executes in the customer's own account, and they read every
568 * line of its log. The shared plumbing names what the portfolio runs on (this
569 * module's Axiom lines, the Telegram alerts), and actor code names its
570 * unblockers, proxies, CAPTCHA solvers and enrichment APIs, down to key
571 * suffixes and a vendor's own error body. A paying Etsy customer's run on
572 * 2026-09-23 showed all of it: scrape.do 401s quoting its dashboard URL, both
573 * key suffixes, the Scrapfly fallback, the Axiom and Telegram wiring.
574 *
575 * So on a run started by anyone but the owner, the console capture still
576 * RECORDS every line (both Axiom tails keep the full story) but does not PRINT
577 * a line that
578 *   - opens with a plumbing tag from INTERNAL_TAGS, or
579 *   - names a service from VENDOR_RE in any argument, or
580 *   - carries a URL with a password in it.
581 * A line carrying any other credential redactText knows (`?token=…`,
582 * `&api_key=…`, `Authorization: Bearer …`, a cookie) prints with the credential
583 * masked. An object or Error argument is read the way the console prints it,
584 * properties included (see SCAN_INSPECT_OPTIONS).
585 * The crash guard's fatal line is the exception: it prints retagged [fatal],
586 * so a customer whose run dies still sees why. When that line names a vendor or
587 * carries a URL with a password, it prints as one masked line instead (see
588 * fatalSummary). Owner runs and local runs (no APIFY_USER_ID) print everything,
589 * exactly as before.
590 */
591const OWNER_USER_ID = 'ngn8vRESTkseyWE6p'; // memo23
592
593/** A run started by anyone but the owner. Local runs have no APIFY_USER_ID and are not. */
594function isCustomerRun(): boolean {
595    const userId = process.env.APIFY_USER_ID;
596    return !!userId && userId !== OWNER_USER_ID;
597}
598
599// Exact, case-sensitive: the shared modules' own tags plus the proxy and
600// unblocker plumbing tags actors use. Vendor-named tags ([SCRAPEDO], [scrape.do],
601// [GEONODE], a runtime [${via}]) need no entry; VENDOR_RE catches them.
602// SB-BUDGET (shared-scrapingbee-budget), NET (shared-got-bounded) and run-guard
603// (shared-run-guard) joined on 2026-10-23. A customer saw '[SB-BUDGET] budget
604// check failed …' in the week to 10-22, and run-guard's log line tells the reader
605// to set ALLOW_EMPTY_RESULT=1 on the Actor, which only the owner can do. The
606// customer still reads run-guard's reason in the run's status message.
607const INTERNAL_TAGS = new Set([
608    'TELEMETRY', 'FAIL-ALERT', 'LIFECYCLE', 'lifecycle', 'T', 'Telegram', 'telegram-guard', 'sendToTelegram',
609    'ACTOR_ENV', 'PROXY', 'proxy', 'unblocker', 'UNBLOCK', 'waf', 'IMPERS',
610    'SB-BUDGET', 'NET', 'run-guard',
611]);
612
613// Paid services the portfolio fetches, proxies, solves or enriches through
614// (surveyed across every registered actor's source on 2026-09-23). A substring
615// match on purpose: the names turn up inside identifiers (SCRAPEDO_KEYS,
616// fetchViaScrapedo) and in stack-trace file names. Axiom and Telegram match by
617// domain only, since both are ordinary words and the portfolio scrapes Telegram.
618// HikerAPI and LamaTok joined on 2026-09-30. A hiker is an ordinary word in the
619// usernames and hashtags the Instagram actors log, so HikerAPI matches only by its
620// name (HikerAPI, api.hikerapi.com, HIKER_API_KEY), its client's error class
621// (HikerError) and the names in its stack traces (lib/hikerClient.js,
622// fetchProfileViaHiker). LamaTok matches anywhere. Turso joined on 2026-10-26: the
623// page cache and the permanent people store (people-leads-memo23) write to it from
624// customer runs, and an error quoting its URL would name our database.
625const VENDOR_RE = new RegExp([
626    'scrape[.\\-_]?do', 'scrapfly', 'zyte', 'scrapingbee', 'oxylabs', 'geonode', 'crawlbase', 'zenrows', 'scraperapi',
627    'browserless', 'evomi', 'ipcook', 'scrapegw', 'bright ?data', 'brd\\.superproxy', 'luminati', 'smartproxy', 'decodo',
628    'webshare', 'dataimpulse', 'proxyscrape', 'soax', 'iproyal', 'netnut', 'thordata', 'proxyempire', 'capsolver',
629    '2captcha', 'anti-?captcha', 'capmonster', 'nopecha', 'rocketreach', 'hunter\\.io', 'clearbit', 'serpapi',
630    'dataforseo', 'axiom\\.co', 'api\\.telegram\\.org',
631    'hiker[ _.-]?api', 'hikererror', 'libs?\\/hiker', 'viahiker', 'lamatok', 'turso',
632].join('|'), 'i');
633
634// The same alternatives, for masking every match in a line (maskTooling).
635const VENDOR_MASK_RE = new RegExp(VENDOR_RE.source, 'gi');
636
637// user:password@ inside a URL: proxy errors quote their own URL.
638const CREDENTIAL_URL_RE = /:\/\/[^:\s/@]+:[^@\s/]+@/;
639
640// The leading [tag] of a line. An Apify logger line puts its level first
641// ("INFO  [TAG] …") and may colour it, so colour is stripped before matching.
642// eslint-disable-next-line no-control-regex
643const ANSI_RE = /\u001b\[[0-9;]*[A-Za-z]/g;
644const LEADING_TAG_RE = /^\s*(?:[A-Z]+\s+)?\[([^\]]+)\]/;
645
646// Only the head of a long argument is scanned, so a logged page body costs a
647// bounded regex pass. Actors slice what they log; a vendor named past this is rare.
648const VENDOR_SCAN_CHARS = 4000;
649
650// An object or Error argument is scanned as the console prints it: through
651// util.inspect, properties included. Until 2026-09-28 only strings and an Error's
652// message and stack were read. On 2026-09-27 zonaprop's customer runs printed the
653// IPCook pool's user and password that way: a failed token call logged got's
654// RequestError, whose options.context.proxyUrl carries both, under a message
655// ("RequestError: connect …") that names no vendor.
656//
657// The depth is the inspect default, which is what console.log prints with, so a
658// line is never hidden over text that would not reach the screen. Deeper costs
659// more (4x on that RequestError) and fills the scan window with text that never
660// prints. One line, so more of the object fits the window. Strings inside the
661// object are cut at the window, as a top-level string is.
662//
663// Cost: the inspect costs about what the console's own formatting of the same
664// argument costs (measured 2026-09-28: 0.07 ms for the RequestError, 2.8 ms for a
665// 1,000-item array that took the console 5 ms), and only customer runs pay it,
666// only for calls that pass an object.
667const SCAN_INSPECT_OPTIONS = { breakLength: Infinity, maxStringLength: VENDOR_SCAN_CHARS };
668
669/** Whether this text names a vendor or carries a URL with a password. */
670function exposesTooling(head: string): boolean {
671    return VENDOR_RE.test(head) || CREDENTIAL_URL_RE.test(head);
672}
673
674/** Whether redactText would mask a credential in this text. Colour alone does not count. */
675function carriesCredential(head: string): boolean {
676    const plain = head.replace(ANSI_RE, '');
677    return redactText(plain) !== plain;
678}
679
680/**
681 * Text with its credentials (redactText, plus the user in a URL's userinfo) and
682 * every vendor name masked. For what a customer reads when a line cannot simply
683 * be left out: the crash guard's fatal line and the run's status message.
684 * Idempotent, like redactText.
685 */
686function maskTooling(s: string): string {
687    return redactText(s)
688        .replace(/(:\/\/)[^\s/@:'"]+(?=:\*\*\*@)/g, '$1***')
689        .replace(VENDOR_MASK_RE, '***');
690}
691
692// What the crash guard (shared-telegram/patch-telegram-crash-guard.mjs) prints first
693// when it lets a crash through: '[telegram-guard] fatal uncaughtException:', err.
694const FATAL_GUARD = '[telegram-guard] fatal';
695
696/**
697 * The crash guard's fatal line for a customer when the crash names a vendor or a
698 * proxy URL: `[fatal] <class>: <message>`, both masked, no stack. Until
699 * 2026-10-23 such a line was hidden whole, so a run that died of it told the
700 * customer nothing. The class is the error's name, or the guard's event
701 * (uncaughtException, unhandledRejection) when what was thrown is not an Error.
702 */
703function fatalSummary(first: string, rest: any[]): string {
704    const err = rest.find((a) => a instanceof Error || (a !== null && typeof a === 'object' && typeof a.message === 'string'));
705    const event = /fatal\s+(\w+)/.exec(first)?.[1] ?? 'Error';
706    const cls = typeof err?.name === 'string' && err.name ? err.name : event;
707    const message = err
708        ? String(err.message)
709        : rest.map((a) => (typeof a === 'string' ? a : inspect(a, SCAN_INSPECT_OPTIONS))).join(' ');
710    return `[fatal] ${maskTooling(cls)}: ${maskTooling(message)}`;
711}
712
713/**
714 * The arguments a customer run prints for one console call, or null for none.
715 * They come back as the same array when nothing changed; a line that carries a
716 * credential comes back as one string, formatted the way the console formats it,
717 * with the credential masked. `scanOptions` reads object arguments; console.dir
718 * passes its own depth.
719 */
720function customerView(args: any[], scanOptions: object = SCAN_INSPECT_OPTIONS): any[] | null {
721    const first = typeof args[0] === 'string' ? args[0] : '';
722    const tag = LEADING_TAG_RE.exec(first.replace(ANSI_RE, ''))?.[1];
723    const fatal = tag === 'telegram-guard' && first.includes(FATAL_GUARD);
724    if (tag !== undefined && INTERNAL_TAGS.has(tag) && !fatal) return null;
725    let mask = false;
726    for (const a of args) {
727        let text: string;
728        if (typeof a === 'string') text = a;
729        else if (a !== null && (typeof a === 'object' || typeof a === 'function')) text = inspect(a, scanOptions);
730        else continue;
731        const head = text.length > VENDOR_SCAN_CHARS ? text.slice(0, VENDOR_SCAN_CHARS) : text;
732        if (exposesTooling(head)) return fatal ? [fatalSummary(first, args.slice(1))] : null;
733        if (!mask && carriesCredential(head)) mask = true;
734    }
735    const shown = fatal ? [first.replace(FATAL_GUARD, '[fatal]'), ...args.slice(1)] : args;
736    return mask ? [redactText(format(...shown))] : shown;
737}
738
739// One capture per process: initRunTelemetry installs it before it knows whether it
740// can send anything, so a second call must not wrap the console again.
741let consoleCaptureInstalled = false;
742
743/**
744 * Wrap the console to count and keep the tail of error output, so heartbeats
745 * carry a log tail for hard-killed runs. The wrappers delegate first and
746 * swallow their own bookkeeping errors. The one change to what prints: on a
747 * customer run, customerView() keeps internal lines off the screen. They are
748 * still recorded.
749 *
750 * Every console method that prints goes through customerView. Until 2026-10-23
751 * only error, warn and log were wrapped, and Node's info, debug and dirxml are
752 * copies of the original log that never call console.log, so they printed
753 * unfiltered; so did dir, which writes on its own. @apify/log prints DEBUG
754 * through console.debug, so a customer who set APIFY_LOG_LEVEL=DEBUG read every
755 * debug line, vendor ladders included. Node prints trace through console.error
756 * and table, group, assert, count and time* through console.log or console.warn,
757 * so those reach the wrappers below on their own; trace and table are wrapped
758 * only so the tag rule sees their arguments.
759 */
760function installConsoleCapture(): void {
761    if (consoleCaptureInstalled) return;
762    consoleCaptureInstalled = true;
763    const hideInternal = isCustomerRun();
764    // Both tails ship to Axiom, and log lines routinely carry credentials - a
765    // proxy URL with its password, a token in a query string. Scrub the obvious
766    // shapes at capture time rather than trusting every actor's logging.
767    // Order matters. The scheme pass runs BEFORE the key=value pass: matching
768    // `authorization":"Bearer eyJ…` on the key alone consumed only the word
769    // "Bearer" and left the token itself in the clear (caught while testing).
770    // Crawlee logs in colour, so 17% of captured lines arrived carrying ANSI
771    // escapes (measured over 46k live lines on 2026-08-26). They are invisible
772    // noise that still eats into the 200-char budget - strip them first.
773    // The passes themselves now live in the module-level redactText, so the
774    // console tail, the run-end telemetry fields and the run's statusMessage all
775    // censor identically instead of drifting apart as three near-copies.
776    const scrub = redactText;
777    const render = (args: any[]) => scrub(args
778        .map((a) => (typeof a === 'string' ? a : a instanceof Error ? a.message : (() => { try { return JSON.stringify(a); } catch { return String(a); } })()))
779        .join(' '));
780    // The log path must stay cheap: it runs on EVERY console.log in the fleet,
781    // and plenty of actors log whole parsed payloads. Deep-stringifying those on
782    // every call would tax hot loops to produce a line we then cut to 200 chars,
783    // so objects get a shape preview (O(keys)) instead of their contents.
784    const renderLight = (args: any[]) => scrub(args
785        .map((a) => {
786            if (typeof a === 'string') return a;
787            if (a instanceof Error) return a.message;
788            if (a === null || typeof a !== 'object') return String(a);
789            return Array.isArray(a) ? `[Array(${a.length})]` : `{${Object.keys(a).slice(0, 6).join(',')}}`;
790        })
791        .join(' '));
792    // kind: 'error' counts and fills the error tail; 'warn' counts and narrates;
793    // 'log' only narrates. Counters keep their original meaning - console.log
794    // must not inflate warnCount.
795    const record = (kind: 'error' | 'warn' | 'log', args: any[]) => {
796        try {
797            if (!state) return;
798            if (kind === 'error') state.errorCount++;
799            else if (kind === 'warn') state.warnCount++;
800            if (kind === 'error') {
801                state.lastErrors.push(render(args).slice(0, MAX_ERROR_LINE_CHARS));
802                if (state.lastErrors.length > MAX_KEPT_ERROR_LINES) state.lastErrors.shift();
803            } else {
804                state.lastLog.push(renderLight(args).slice(0, MAX_LOG_LINE_CHARS));
805                if (state.lastLog.length > MAX_KEPT_LOG_LINES) state.lastLog.shift();
806            }
807        } catch { /* never interfere with logging */ }
808    };
809    const view = (args: any[], scanOptions?: object): any[] | null => {
810        if (!hideInternal) return args;
811        try { return customerView(args, scanOptions); } catch { return args; }
812    };
813    const wrap = (orig: (...a: any[]) => void, kind: 'error' | 'warn' | 'log') => (...args: any[]) => {
814        const shown = view(args);
815        if (shown) orig(...shown);
816        record(kind, args);
817    };
818    // eslint-disable-next-line no-console
819    console.error = wrap(console.error.bind(console), 'error');
820    // eslint-disable-next-line no-console
821    console.warn = wrap(console.warn.bind(console), 'warn');
822    // eslint-disable-next-line no-console
823    console.log = wrap(console.log.bind(console), 'log');
824    // Recorded as narration, as console.log is: they print to stdout like it.
825    // eslint-disable-next-line no-console
826    console.info = wrap(console.info.bind(console), 'log');
827    // eslint-disable-next-line no-console
828    console.debug = wrap(console.debug.bind(console), 'log');
829    // eslint-disable-next-line no-console
830    console.dirxml = wrap(console.dirxml.bind(console), 'log');
831    // dir prints one object at the depth its options ask for, so the scan reads it at
832    // that depth. A line the filter would rewrite cannot be rewritten as a dir, so it
833    // is left out instead.
834    const dir = console.dir.bind(console);
835    // eslint-disable-next-line no-console
836    console.dir = (obj?: any, options?: any) => {
837        const one = [obj];
838        const scan = options && typeof options === 'object' ? { ...options, ...SCAN_INSPECT_OPTIONS, colors: false } : undefined;
839        if (view(one, scan) === one) dir(obj, options);
840        record('log', one);
841    };
842    // Node prints a table through console.log, whose wrapper scans and records the
843    // rendered table. This only adds the tag rule, which the rendered table no longer
844    // starts with, and leaves out a table the filter would rewrite.
845    const table = console.table.bind(console);
846    // eslint-disable-next-line no-console
847    console.table = (data?: any, properties?: any) => {
848        const args = properties === undefined ? [data] : [data, properties];
849        if (view(args) === args) table(data, properties);
850        else record('log', args);
851    };
852    // Node's own trace, built here instead of called: it prints `Trace: <message>`
853    // and the stack through console.error, so the error wrapper scans the stack and
854    // records it, as before. Calling the original would add this wrapper's frame to
855    // every stack. The tag rule reads the arguments, before `Trace: ` is put in front.
856    // eslint-disable-next-line no-console
857    console.trace = function trace(...args: any[]) {
858        const shown = view(args);
859        if (!shown) {
860            record('error', args);
861            return;
862        }
863        const t: { name: string; message: string; stack?: string } = { name: 'Trace', message: format(...shown) };
864        Error.captureStackTrace(t, trace);
865        // eslint-disable-next-line no-console
866        console.error(t.stack);
867    };
868}
869
870/**
871 * Best available platform-side item count for the default dataset. Two views,
872 * both eventually consistent but not in lockstep:
873 *   getInfo().itemCount - the dataset RECORD's denormalised counter, which the
874 *     platform updates asynchronously (has read 0 for >2.5 s after the final
875 *     push: run hMKhqY5DQpo0oWGrF had 3 rows and reported 0).
876 *   getData().total     - computed by the items endpoint from the item store,
877 *     often fresher. Only probed when the cheap counter still reads 0/unknown,
878 *     so the steady-state heartbeat stays at one API call.
879 * Returns the higher of the two, or null when the dataset can't be read at all
880 * (null = unknown, which is NOT the same as a real 0).
881 */
882async function currentItemCount(): Promise<number | null> {
883    let best: number | null = null;
884    const consider = (n: unknown) => {
885        const v = Number(n);
886        if (Number.isFinite(v) && v >= 0 && (best === null || v > best)) best = v;
887    };
888    let dataset: any;
889    try { dataset = await Actor.openDataset(); } catch { return null; }
890    try { consider((await dataset.getInfo())?.itemCount); } catch { /* keep null */ }
891    if (!best) {
892        try { consider((await dataset.getData({ limit: 1 }))?.total); } catch { /* keep whatever we have */ }
893    }
894    return best;
895}
896
897async function heartbeatFields(full = false): Promise<Record<string, unknown>> {
898    return progressFields(await currentItemCount(), full);
899}
900
901/**
902 * heartbeatFields(true) for a run-end that races the kill: the platform count
903 * gets LAST_GASP_COUNT_MS, then the fields go without it. The in-process push
904 * counter costs no API call, so itemsPushed is always there.
905 */
906function lastGaspFields(): Promise<Record<string, unknown>> {
907    return new Promise((resolve) => {
908        const timer: any = setTimeout(() => resolve(progressFields(null, true)), LAST_GASP_COUNT_MS);
909        currentItemCount().then(
910            (n) => { clearTimeout(timer); resolve(progressFields(n, true)); },
911            () => { clearTimeout(timer); resolve(progressFields(null, true)); },
912        );
913    });
914}
915
916function progressFields(platformCount: number | null, full: boolean): Record<string, unknown> {
917    const pushed = state?.pushedCount ?? 0;
918    const rejected = state?.rejectedCount ?? 0;
919    const errorRows = state?.errorRowCount ?? 0;
920    return {
921        // itemsPushed = in-process counter (patches Dataset.prototype.pushData
922        // on the class the apify SDK itself uses, so it sees every push path:
923        // Actor.pushData, the static Dataset.pushData, crawler context.pushData
924        // - and pushes to NAMED datasets, which the platform count below misses).
925        // itemCount = platform default-dataset count (eventually consistent, so
926        // it can lag several seconds behind the last push; null = unreadable).
927        // itemsProduced = max of the two, less the error rows → the AUTHORITATIVE
928        // "did it produce items" signal. Read it together with pushCounterLive.
929        // Error rows are counted only by the push counter, so without it nothing comes off.
930        itemsPushed: pushed,
931        itemCount: platformCount,
932        itemsProduced: Math.max(0, Math.max(pushed, platformCount ?? 0) - errorRows),
933        pushCounterLive: state?.pushCounterLive ?? false,
934        // Items the platform refused (not in itemsPushed). Only on runs that had any, and
935        // not in TOP_LEVEL_FIELDS, so it rides in the map: extra.itemsRejected > 0.
936        ...(rejected ? { itemsRejected: rejected } : {}),
937        // Same: only on runs that pushed any, as extra.itemsErrorRows.
938        ...(errorRows ? { itemsErrorRows: errorRows } : {}),
939        errorCount: state?.errorCount ?? 0,
940        warnCount: state?.warnCount ?? 0,
941        // full=true (run-end) ships the deep error tail; heartbeats ship only the
942        // newest few, since they fire every 45 s on every run in the fleet.
943        lastErrors: full
944            ? (state?.lastErrors ?? [])
945            : (state?.lastErrors ?? []).slice(-HEARTBEAT_ERROR_LINES),
946        lastLog: state?.lastLog ?? [],
947        rssMB: Math.round(process.memoryUsage().rss / (1024 * 1024)),
948    };
949}
950
951/**
952 * Patch Dataset.prototype.pushData to count pushed items live. Actor.pushData,
953 * the static Dataset.pushData and crawler context.pushData all funnel through
954 * this one method.
955 *
956 * The patch target is the `Dataset` re-exported by **apify** - the very class
957 * `Actor.openDataset()` hands back (apify re-exports @crawlee/core's Dataset;
958 * verified `coreDataset === apifyDataset`). Every consumer actor depends on
959 * apify by definition, so this target always resolves.
960 *
961 * It used to patch `import('crawlee')` instead, and that silently no-opped on
962 * every actor that doesn't list the crawlee META-package as a dependency -
963 * pure-HTTP actors get @crawlee/core transitively via apify, but `crawlee`
964 * itself is absent, so the import threw ERR_MODULE_NOT_FOUND, the catch
965 * swallowed it and pushedCount stayed 0 for the whole run. itemsPushed was
966 * then 0 on every event, and a run-end that also caught the platform itemCount
967 * mid-lag reported itemsProduced 0 for a run that really produced rows
968 * (memo23~nmls-scraper run hMKhqY5DQpo0oWGrF: 3 rows, reported 0), which is
969 * what corrupted the portfolio-wide zero-item metric.
970 *
971 * crawlee is still patched too, but only when it resolves to a DIFFERENT class
972 * object (duplicate @crawlee/core copies in node_modules) - the per-prototype
973 * flag keeps a shared class from being counted twice.
974 */
975/**
976 * Does this row carry an error instead of data? The rule runGuard uses (isErrorRow there),
977 * so telemetry and the empty-run guard agree on what counts as an item.
978 */
979function isErrorRow(row: unknown): boolean {
980    if (!row || typeof row !== 'object') return false;
981    const r = row as Record<string, unknown>;
982    if (r.error !== undefined && r.error !== null && r.error !== false && r.error !== '') return true;
983    return r.success === false;
984}
985
986async function installPushCounter(): Promise<void> {
987    const patchProto = (proto: any): boolean => {
988        try {
989            if (typeof proto?.pushData !== 'function') return false;
990            if (proto.__telemetryPushPatched) return true; // patched by an earlier init - still live
991            const orig = proto.pushData;
992            proto.pushData = async function (this: any, data: any, ...rest: any[]) {
993                let counts = false;
994                try {
995                    // Count the DEFAULT dataset only. A named dataset (Actor.openDataset('x'))
996                    // is a side output - an actor that emits summaries/aggregates there would
997                    // otherwise push itemsProduced above the platform's default-dataset
998                    // itemCount, i.e. above the row count that `apify-default-dataset-item`
999                    // bills on, making healthy runs look like they under-charged.
1000                    // Matched on ID, not name: the default dataset reports name 'default'
1001                    // under the local memory storage client but has no name on the platform,
1002                    // so a name check silently flips behaviour between dev and production.
1003                    // Unresolved id (null) → count everything, preserving the old behaviour
1004                    // rather than silently reporting 0.
1005                    counts = !!state && (!state.defaultDatasetId || this?.id === state.defaultDatasetId);
1006                } catch { /* counting must never break pushes */ }
1007                // Counted once the push settles, never before: a push the platform refuses
1008                // (dataset schema validation) throws, and those rows were never saved.
1009                const n = Array.isArray(data) ? data.length : 1;
1010                let out: any;
1011                try {
1012                    out = await orig.call(this, data, ...rest);
1013                } catch (e) {
1014                    if (counts && state) state.rejectedCount += n;
1015                    throw e;
1016                }
1017                if (counts && state) {
1018                    state.pushedCount += n;
1019                    try { state.errorRowCount += (Array.isArray(data) ? data : [data]).filter(isErrorRow).length; } catch { /* never break a push */ }
1020                }
1021                return out;
1022            };
1023            proto.__telemetryPushPatched = true;
1024            return true;
1025        } catch { return false; }
1026    };
1027
1028    let patched = 0;
1029    if (patchProto((Dataset as any)?.prototype)) patched++;
1030    try {
1031        // Specifier via a variable, NOT a literal: a literal import('crawlee')
1032        // is a compile error (TS2307) in consumer actors that don't depend on
1033        // crawlee. This keeps the module compile-safe everywhere and resolves
1034        // (or cleanly fails) at runtime only.
1035        const crawleeModuleName = 'crawlee';
1036        const crawlee: any = await import(crawleeModuleName).catch(() => null);
1037        if (crawlee?.Dataset && crawlee.Dataset !== (Dataset as any) && patchProto(crawlee.Dataset.prototype)) patched++;
1038    } catch { /* crawlee absent - the apify-side patch above is the one that matters */ }
1039
1040    if (state) state.pushCounterLive = patched > 0;
1041    if (!patched) console.log('[TELEMETRY] push counter not installed - itemsPushed will read 0; itemCount is the only source');
1042}
1043
1044/**
1045 * Redact the run's statusMessage on its way out of Actor.exit / Actor.fail.
1046 *
1047 * statusMessage is the most exposed string an actor produces: the CUSTOMER reads
1048 * it on their run, and the failure webhook forwards it to Telegram verbatim
1049 * through the platform's {{resource.statusMessage}} template - so nothing on
1050 * this path was ever censored. The fleet-standard wiring emitted by
1051 * sync-telemetry.sh --wire ends every actor with
1052 *     Actor.exit({ exitCode: 1, statusMessage: `FAILED: ${err.message}` })
1053 * which publishes whatever the error happened to quote. During the 2026-08-25..
1054 * 09-01 Evomi outage that error was "Proxy responded with 407 ...
1055 * http://user:<password>@host:port", written out on every failed run.
1056 *
1057 * Patching here rather than in each actor is deliberate: the same three lines
1058 * are copy-pasted across the fleet, so one call site cannot be fixed in place.
1059 *
1060 * On a customer run the status message also has every vendor name masked
1061 * (maskTooling): the fleet's catch tail writes `FAILED: ${err.message}`, and an
1062 * unblocker ladder's error lists every provider it tried ('unblock: every
1063 * provider failed | evomi:… | geonode:…'), which the customer read in the run
1064 * header until 2026-10-23. The failure alert forwards the same masked text; the
1065 * names stay in run-end's errorMessage in Axiom. Actor.setStatusMessage, which
1066 * actors call mid-run and Actor.exit calls underneath, gets the same treatment.
1067 *
1068 * Safety: this only ever REWRITES A STRING. Argument count is preserved (some
1069 * SDK paths branch on arguments.length), `this` is preserved, the original's
1070 * return value is passed straight back, and any failure inside the redaction
1071 * falls through to the untouched original - a censoring bug must never stop a
1072 * run from exiting.
1073 */
1074function installExitRedaction(): void {
1075    const clean = isCustomerRun() ? maskTooling : redactText;
1076    const redactArgs = (args: any[]): any[] => {
1077        try {
1078            return args.map((a) => {
1079                if (typeof a === 'string') return clean(a);
1080                if (a && typeof a === 'object' && typeof a.statusMessage === 'string') {
1081                    return { ...a, statusMessage: clean(a.statusMessage) };
1082                }
1083                return a;
1084            });
1085        } catch {
1086            return args; // redaction failed - exit with the original message rather than not at all
1087        }
1088    };
1089
1090    const patch = (target: any, name: 'exit' | 'fail' | 'setStatusMessage'): boolean => {
1091        try {
1092            const orig = target?.[name];
1093            if (typeof orig !== 'function') return false;
1094            if (orig.__telemetryExitPatched) return true; // an earlier init already wrapped it
1095            const wrapped = function (this: any, ...args: any[]) {
1096                return orig.apply(this, redactArgs(args));
1097            };
1098            (wrapped as any).__telemetryExitPatched = true;
1099            target[name] = wrapped;
1100            return true;
1101        } catch { return false; }
1102    };
1103
1104    // The static methods are what actors call; the prototype covers the rarer
1105    // Actor.getDefaultInstance().exit() path. redactText and maskTooling are
1106    // idempotent, so a string passing through both is censored once and unchanged
1107    // the second time.
1108    let patched = 0;
1109    const proto = (Actor as any)?.prototype;
1110    for (const name of ['exit', 'fail', 'setStatusMessage'] as const) {
1111        if (patch(Actor as any, name)) patched++;
1112        if (proto && patch(proto, name)) patched++;
1113    }
1114    if (!patched) console.log('[TELEMETRY] statusMessage redaction not installed - exit messages ship unredacted');
1115}
1116
1117/**
1118 * Live in-process count of items pushed this run (from the patched
1119 * Dataset.prototype.pushData), counting only pushes the platform accepted.
1120 * This is the AUTHORITATIVE "did the run produce anything" signal - it counts
1121 * every push path (list, detail pages, static
1122 * Dataset.pushData), unlike a handler-local counter that only sees one route.
1123 * Use it to gate 0-item diagnostics so a run that pushed via a non-list path
1124 * isn't misclassified as zero.
1125 */
1126export function getPushedItemCount(): number {
1127    return state?.pushedCount ?? 0;
1128}
1129
1130/**
1131 * The run's platform timeout, for run-start. A run that logs run-start and never
1132 * run-end died hard, and its heartbeats cannot say how: a TIMED-OUT run and an
1133 * immediate ABORT leave the same trail, and the owner cannot read customer runs
1134 * through the API (403). The clutch investigation on 2026-09-19 had to infer
1135 * timeouts from where last heartbeats clustered (3556-3567 s under the 3600 s
1136 * default) and could not classify 9 of 28 start-only runs at all. With this on
1137 * run-start, a start-only run whose death window (last event to ~45 s later)
1138 * contains timeoutAt timed out; one whose window ends before it was aborted,
1139 * crashed or ran out of memory.
1140 *
1141 *   timeoutAt   - ISO time the platform kills the run (ACTOR_TIMEOUT_AT).
1142 *   timeoutSecs - seconds from the run's platform start (ACTOR_STARTED_AT) to
1143 *                 timeoutAt, i.e. the configured timeout: 3600 is the default.
1144 *
1145 * Neither name is in TOP_LEVEL_FIELDS, so routeFields() files both under the map
1146 * field (extra.timeoutAt, extra.timeoutSecs) and they cost no columns. Both are
1147 * left out when no timeout can be read: a run without one, or a local run.
1148 *
1149 * Since 2026-10-06 a run that times out also sends run-end TIMED-OUT (see
1150 * armTimeoutFlush), so this test is needed only for builds older than that.
1151 */
1152function runTimeoutFields(): Record<string, unknown> {
1153    const timeout = runTimeout();
1154    return timeout ? { timeoutAt: new Date(timeout.atMs).toISOString(), timeoutSecs: timeout.secs } : {};
1155}
1156
1157/** When the platform kills this run, and its configured timeout; null when there is none. */
1158function runTimeout(): { atMs: number; secs: number } | null {
1159    try {
1160        // getEnv() through `any`: its typing varies across the SDK versions the
1161        // consumer actors pin. The raw env vars cover an SDK that lacks it.
1162        let sdkEnv: any = null;
1163        try { sdkEnv = (Actor as any).getEnv?.(); } catch { /* fall back to the raw env vars */ }
1164        const env = process.env;
1165        const toMs = (v: unknown): number => {
1166            const ms = v instanceof Date ? v.getTime() : typeof v === 'string' ? Date.parse(v) : NaN;
1167            return Number.isFinite(ms) && ms > 0 ? ms : NaN;
1168        };
1169        const timeoutMs = toMs(sdkEnv?.timeoutAt ?? env.ACTOR_TIMEOUT_AT ?? env.APIFY_TIMEOUT_AT);
1170        if (!Number.isFinite(timeoutMs)) return null;
1171        let startMs = toMs(sdkEnv?.startedAt ?? env.ACTOR_STARTED_AT ?? env.APIFY_STARTED_AT);
1172        // Without the platform start, time from telemetry init: a few seconds short.
1173        if (!Number.isFinite(startMs)) startMs = state?.startedAtMs ?? Date.now();
1174        const timeoutSecs = Math.round((timeoutMs - startMs) / 1000);
1175        if (!(timeoutSecs > 0)) return null;
1176        return { atMs: timeoutMs, secs: timeoutSecs };
1177    } catch {
1178        return null;
1179    }
1180}
1181
1182/**
1183 * Send run-end TIMED-OUT PRE_TIMEOUT_LEAD_MS before the run's timeout. The
1184 * platform SIGKILLs the container at ACTOR_TIMEOUT_AT and sends no event first,
1185 * so a run that times out never reaches the actor's own finish path. When the
1186 * actor has already sent its run-end (its own soft deadline, a finish just in
1187 * time), this sends nothing. A delay longer than setTimeout can hold is covered
1188 * in steps.
1189 */
1190function armTimeoutFlush(): void {
1191    try {
1192        const timeout = runTimeout();
1193        if (!state || !timeout) return;
1194        const flushAtMs = timeout.atMs - PRE_TIMEOUT_LEAD_MS;
1195        // A run that starts inside the window (a migration near the end) gets no flush.
1196        if (flushAtMs <= Date.now()) return;
1197        const arm = (): void => {
1198            if (!state || state.endSent || state.migrating) return;
1199            const waitMs = flushAtMs - Date.now();
1200            if (waitMs <= 0) {
1201                void endRun('TIMED-OUT', { errorMessage: `Run timed out (timeout ${timeout.secs} s)` }, true, 'deadline');
1202                return;
1203            }
1204            state.timeoutTimer = setTimeout(arm, Math.min(waitMs, MAX_TIMER_MS));
1205            // Never keep the actor process alive just for telemetry.
1206            state.timeoutTimer.unref?.();
1207        };
1208        arm();
1209    } catch { /* telemetry must never throw */ }
1210}
1211
1212/**
1213 * Start telemetry for this run. Call once, right after Actor.init().
1214 * Safe to call with the token unconfigured: the customer log filter and the
1215 * statusMessage redaction still go in, then a single warn, and nothing is sent.
1216 * `brand` is optional - it defaults to the platform-provided actor name, so
1217 * consumer actors wire the identical line `await initRunTelemetry();`.
1218 */
1219export async function initRunTelemetry(brand?: string): Promise<void> {
1220    try {
1221        if (state) return; // already initialised (resurrection-safe)
1222        // What the customer reads is filtered whether or not telemetry can send:
1223        // until 2026-10-23 an unset token returned before the console capture, and
1224        // the whole run printed unfiltered. Both installs are idempotent.
1225        installConsoleCapture();
1226        installExitRedaction();
1227        if (!tokenConfigured()) {
1228            console.warn('[TELEMETRY] Axiom ingest token not set in runTelemetry.ts - run telemetry disabled');
1229            return;
1230        }
1231        state = {
1232            brand: brand || process.env.ACTOR_FULL_NAME || process.env.ACTOR_ID || 'unknown-actor',
1233            startedAtMs: Date.now(),
1234            heartbeatTimer: null,
1235            errorCount: 0,
1236            warnCount: 0,
1237            lastErrors: [],
1238            lastLog: [],
1239            ingestFailures: 0,
1240            endSent: false,
1241            endPromise: null,
1242            timeoutTimer: null,
1243            migrating: false,
1244            abortWebhook: null,
1245            pushedCount: 0,
1246            rejectedCount: 0,
1247            errorRowCount: 0,
1248            pushCounterLive: false,
1249            defaultDatasetId: null,
1250        };
1251        // Resolve the default dataset's id BEFORE the counter is installed, so the
1252        // very first push is already scoped correctly.
1253        try { state.defaultDatasetId = (await Actor.openDataset())?.id ?? null; } catch { /* stays null → count everything */ }
1254        await installPushCounter();
1255
1256        let input: unknown;
1257        try { input = redactSecrets((await Actor.getInput()) ?? {}); } catch { input = '(input unavailable)'; }
1258        let inputJson = JSON.stringify(input);
1259        if (inputJson.length > MAX_INPUT_JSON_CHARS) inputJson = `${inputJson.slice(0, MAX_INPUT_JSON_CHARS)}…(truncated from ${inputJson.length} chars)`;
1260
1261        void send('run-start', { input: inputJson, ...runTimeoutFields() });
1262        // Not awaited: one API call that init need not wait for. A run-end that
1263        // comes before it lands waits for it instead (dropAbortWebhook).
1264        state.abortWebhook = registerAbortWebhook();
1265
1266        // A graceful abort (gracefully=true on the API) emits `aborting`, and SDK
1267        // 3.5+ answers it by calling Actor.exit() itself, so the actor's own
1268        // finish path never runs. Up to 2026-10-06 this sent an `aborting` event
1269        // and no run-end, and the run read as a crash: 153 of redfin-ppe's 157
1270        // start-only runs in a week were one customer's aborts. The run-end goes
1271        // from here now, and returning its promise makes the SDK's exit wait for
1272        // it. An abort that is not graceful sends no event and kills the container
1273        // at once, so nothing can report that one.
1274        //
1275        // An immediate abort (the default, in the Console and on the API) emits no
1276        // event and kills the process with no grace period; nothing in-process can
1277        // report it. registerAbortWebhook covers that one from the platform.
1278        //
1279        // `migrating` is not an end: the run carries on in a new container, which
1280        // sends run-start again and arms its own timeout flush.
1281        try {
1282            Actor.on('aborting', () => endRun('ABORTED', { errorMessage: 'Run aborted' }, true, 'aborted'));
1283            Actor.on('migrating', () => {
1284                if (state) {
1285                    state.migrating = true;
1286                    if (state.timeoutTimer) clearTimeout(state.timeoutTimer);
1287                }
1288                void heartbeatFields().then((f) => send('migrating', f));
1289            });
1290        } catch { /* platform events unavailable locally on some SDK versions */ }
1291        armTimeoutFlush();
1292
1293        state.heartbeatTimer = setInterval(() => {
1294            void heartbeatFields().then((f) => send('heartbeat', f));
1295        }, HEARTBEAT_MS);
1296        // Never keep the actor process alive just for telemetry.
1297        state.heartbeatTimer.unref?.();
1298
1299        console.log('[TELEMETRY] run telemetry → Axiom enabled (run-start sent, heartbeat every 45s)');
1300    } catch (e) {
1301        console.warn('[TELEMETRY] failed to initialise (non-fatal):', (e as Error).message);
1302    }
1303}
1304
1305/**
1306 * The run-end for an abort that is not graceful, sent by the PLATFORM through the alert relay.
1307 *
1308 * An immediate abort (the default in the Console and on the API) kills the process with no
1309 * grace period and no event, so no code in it runs: on 2026-10-13 instagram-transcript-scraper
1310 * run RafLsTn7VW3phDkwk was aborted at exactly 300 s and left run-start and no run-end. So the
1311 * run registers an ad-hoc ACTOR.RUN.ABORTED webhook at start, and Apify sends it from its
1312 * backend whatever happened to the container, for customer runs too.
1313 *
1314 * The webhook lives in the CUSTOMER's account, where they can read its URL, headers and
1315 * payload, so it carries NO secret. 0820359 posted straight to Axiom with the ingest token in
1316 * its headers and was reverted the same morning (537c163). Now it posts to the relay's
1317 * /v1/run-event with the run id and `sig`, an HMAC of the run id under RUN_EVENT_KEY that only
1318 * the relay and this source know; the relay checks it and ingests with the token it holds (Fly
1319 * secret). The record is fixed JSON known at start (no {{ }} but the run id).
1320 *
1321 * One run-end per run: whenever this process stores a run-end of its own (its finish, a
1322 * graceful abort, the pre-timeout flush), it deletes the webhook. If that delete fails the
1323 * platform's copy still goes, marked extra.endSource = 'platform'.
1324 *
1325 * Platform only, never throws, resolves to the webhook id or null.
1326 */
1327const ALERT_RELAY_URL = 'https://memo23-tg-relay.fly.dev';
1328const RUN_EVENT_KEY = '22be5be44be322d0d5971d2276647f05331333223753ff2be51075bf005431c4';
1329
1330/** hex32 HMAC of the run id; must match runEventSig() in shared-telegram/relay/run-event.mjs. */
1331function runEventSig(runId: string): string {
1332    return createHmac('sha256', RUN_EVENT_KEY).update(`run-event:v1:${runId}`).digest('hex').slice(0, 32);
1333}
1334
1335async function registerAbortWebhook(): Promise<string | null> {
1336    try {
1337        const runId = process.env.ACTOR_RUN_ID || process.env.APIFY_ACTOR_RUN_ID;
1338        if (!runId || !state) return null;
1339        const record = routeFields({
1340            event: 'run-end',
1341            ...baseFields(),
1342            elapsedSec: null,
1343            status: 'ABORTED',
1344            errorMessage: 'Run aborted',
1345            zeroReason: 'aborted',
1346            itemsPushed: null,
1347            itemCount: null,
1348            itemsProduced: null,
1349            endSource: 'platform',
1350        });
1351        // Plain text, never a template: the record carries no {{ }}.
1352        const recordText = JSON.stringify(record).replace(/\{\{/g, '{ {').replace(/\}\}/g, '} }');
1353        const query = new URLSearchParams({ k: 'run-end', r: runId, sig: runEventSig(runId) });
1354        const opts = {
1355            eventTypes: ['ACTOR.RUN.ABORTED'],
1356            // No token anywhere in this webhook: the relay holds the ingest token.
1357            requestUrl: `${ALERT_RELAY_URL}/v1/run-event?${query}`,
1358            payloadTemplate: `{"run":"{{resource.id}}","record":${recordText}}`,
1359            // Run-scoped: a migrated or resurrected run gets the same webhook back.
1360            idempotencyKey: `telemetry-abort-${runId}`,
1361            // Apify fills in a quoted "{{resource.id}}" only with this flag; the record's own
1362            // strings carry no {{ }} (escaped above), so nothing else is touched.
1363            shouldInterpolateStrings: true,
1364        };
1365        let webhook: any;
1366        try {
1367            webhook = await (Actor as any).addWebhook(opts);
1368        } catch {
1369            // Older SDKs refuse shouldInterpolateStrings in addWebhook's own option check; the
1370            // API takes it, and this is what addWebhook does underneath.
1371            webhook = await (Actor as any).newClient().webhooks().create({ ...opts, isAdHoc: true, condition: { actorRunId: runId } });
1372        }
1373        return webhook?.id ?? null;
1374    } catch (e) {
1375        console.warn('[TELEMETRY] abort run-end webhook not registered (non-fatal):', (e as Error).message);
1376        return null;
1377    }
1378}
1379
1380/** Delete the abort webhook, bounded by ABORT_WEBHOOK_DROP_MS. Never throws. */
1381async function dropAbortWebhook(): Promise<void> {
1382    try {
1383        const pending = state?.abortWebhook;
1384        if (!pending || !state) return;
1385        state.abortWebhook = null;
1386        let timer: any;
1387        const giveUp = new Promise<void>((r) => { timer = setTimeout(r, ABORT_WEBHOOK_DROP_MS); });
1388        const drop = pending.then(async (id) => {
1389            if (id) await (Actor as any).newClient().webhook(id).delete();
1390        }).catch(() => { /* the platform copy goes too; endSource tells them apart */ });
1391        await Promise.race([drop, giveUp]);
1392        clearTimeout(timer);
1393    } catch { /* never throw from telemetry */ }
1394}
1395
1396/** Positive finite number, else 0 - for reading caller-supplied counts. */
1397function claimedCount(v: unknown): number {
1398    const n = Number(v);
1399    return Number.isFinite(n) && n > 0 ? n : 0;
1400}
1401
1402/**
1403 * Send the final run-end event. Call just before Actor.exit(). Awaited so the
1404 * event gets out before the process ends, but bounded by the 8 s fetch
1405 * timeout and exception-proof either way.
1406 *
1407 * Getting the item counts right here matters more than anywhere else: run-end
1408 * is what the portfolio-wide zero-item sweep reads, so a count that lands on 0
1409 * for a healthy run makes it look broken (and buries the genuinely broken).
1410 * Three defences, in order of trust:
1411 *   1. the in-process push counter (live the moment a push happens),
1412 *   2. the platform count, POLLED - it is eventually consistent and a single
1413 *      2500 ms wait was not enough (run hMKhqY5DQpo0oWGrF reported 0 for a
1414 *      3-row dataset),
1415 *   3. a caller-supplied `extra.itemsPushed` / `extra.itemsProduced`, used as a
1416 *      FLOOR on all three count fields - the actor counted its own rows, so a
1417 *      positive claim always beats a 0 from the two mechanisms above.
1418 *
1419 * A run sends one run-end. If this module already sent it (an abort, the
1420 * pre-timeout flush), this waits for that send and sends nothing.
1421 */
1422export async function finishRunTelemetry(status = 'SUCCEEDED', extra: Record<string, unknown> = {}): Promise<void> {
1423    await endRun(status, extra, false);
1424}
1425
1426/**
1427 * Start the run's one run-end, or return the one already started. Whoever
1428 * comes first sends it: the actor's finish, the `aborting` listener or the
1429 * pre-timeout flush. `lastGasp` is for the latter two, which race the kill: no
1430 * waiting on the platform item count. `zeroReasonIfEmpty` labels a run-end that
1431 * counts no items, so the zero-item sweep can tell an abort from a broken run.
1432 */
1433function endRun(status: string, extra: Record<string, unknown>, lastGasp: boolean, zeroReasonIfEmpty?: string): Promise<void> {
1434    try {
1435        if (!state) return Promise.resolve();
1436        if (state.endSent) return state.endPromise ?? Promise.resolve();
1437        state.endSent = true;
1438        if (state.heartbeatTimer) clearInterval(state.heartbeatTimer);
1439        if (state.timeoutTimer) clearTimeout(state.timeoutTimer);
1440        state.endPromise = sendRunEnd(status, extra, lastGasp, zeroReasonIfEmpty);
1441        return state.endPromise;
1442    } catch {
1443        return Promise.resolve();
1444    }
1445}
1446
1447async function sendRunEnd(status: string, extra: Record<string, unknown>, lastGasp: boolean, zeroReasonIfEmpty?: string): Promise<void> {
1448    try {
1449        if (!state) return;
1450        const claimed = Math.max(claimedCount(extra.itemsPushed), claimedCount(extra.itemsProduced));
1451        let fields = lastGasp ? await lastGaspFields() : await heartbeatFields(true);
1452        // Nothing visible yet? Give the eventually-consistent platform count
1453        // time to catch up before declaring a true zero-item run. A LIVE push
1454        // counter reading 0 is already strong evidence of a real zero (it sees
1455        // every Dataset push path), so that case gets one short re-check;
1456        // without it the platform count is all we have, so poll up to ~12 s.
1457        // A caller that already told us its own count needs no wait at all, and
1458        // a run-end racing the kill gets none. Neither does a wait that would
1459        // run past the pre-timeout mark: the run-end has to leave before the kill.
1460        const delaysMs = claimed || lastGasp ? [] : state.pushCounterLive ? [2500] : [1000, 2000, 3000, 6000];
1461        const timeout = delaysMs.length ? runTimeout() : null;
1462        const waitUntilMs = timeout ? timeout.atMs - PRE_TIMEOUT_LEAD_MS : Infinity;
1463        for (const ms of delaysMs) {
1464            if (fields.itemsProduced || Date.now() + ms > waitUntilMs) break;
1465            await new Promise((r) => setTimeout(r, ms));
1466            fields = await heartbeatFields(true);
1467        }
1468        // That loop stops the moment itemsProduced is non-zero, which on a fast
1469        // run is immediately — the push counter knows the rows before the
1470        // platform's denormalised counter does. itemsProduced was then right
1471        // while itemCount went out as a known-false 0 (crexi run V9uP2rgkyYVYS0mmJ:
1472        // 15 brokers served from the database in under 4 s, itemsPushed=15,
1473        // itemCount=0). Give the platform one short re-read when the live push
1474        // counter says there are more rows than it can see. Same guards as
1475        // above: never on a caller's own count, never racing the kill.
1476        const behindPush = () => {
1477            const pushed = Number(fields.itemsPushed) || 0;
1478            const seen = fields.itemCount === null ? -1 : Number(fields.itemCount) || 0;
1479            return pushed > 0 && seen < pushed;
1480        };
1481        if (!claimed && !lastGasp && state.pushCounterLive) {
1482            for (const ms of COUNT_SETTLE_MS) {
1483                if (!behindPush() || Date.now() + ms > waitUntilMs) break;
1484                await new Promise((r) => setTimeout(r, ms));
1485                fields = await heartbeatFields(true);
1486            }
1487        }
1488
1489        const platform = fields.itemCount === null ? null : Number(fields.itemCount) || 0;
1490        const counts = {
1491            itemsPushed: Math.max(claimed, Number(fields.itemsPushed) || 0),
1492            // null (dataset unreadable) is preserved as null - "unknown" is not "zero".
1493            // A platform count still below a LIVE push counter after the settle above
1494            // is a counter that has not caught up, not an empty dataset. The module's
1495            // own rule applies: null means unknown, and unknown is not zero. Reporting
1496            // the 0 instead made fast runs look empty in Axiom (crexi V9uP2rgkyYVYS0mmJ
1497            // served 15 rows and sent itemCount=0).
1498            itemCount: platform === null && !claimed ? null
1499                : behindPush() && !claimed ? null
1500                    : Math.max(claimed, platform ?? 0),
1501            // A claimed itemsPushed may include error rows, so they come off it here too;
1502            // a claimed itemsProduced is the actor's own count of data rows and stands as given.
1503            itemsProduced: Math.max(
1504                claimedCount(extra.itemsProduced),
1505                Math.max(0, claimedCount(extra.itemsPushed) - (state.errorRowCount ?? 0)),
1506                Number(fields.itemsProduced) || 0,
1507            ),
1508        };
1509        // Callers build these fields - errorMessage, zeroDetail and friends - by
1510        // interpolating a caught error, and transport errors quote the proxy URL
1511        // WITH its password. Without this, every stale-credential outage writes
1512        // the credential into Axiom. Strings only: count fields and structured
1513        // values pass through untouched.
1514        const safeExtra: Record<string, unknown> = {};
1515        for (const [k, v] of Object.entries(extra)) {
1516            safeExtra[k] = typeof v === 'string' ? redactText(v) : v;
1517        }
1518        const zero = zeroReasonIfEmpty && !counts.itemsProduced && safeExtra.zeroReason === undefined
1519            ? { zeroReason: zeroReasonIfEmpty }
1520            : {};
1521        // Telegram send accounting from the actor's telegram.ts (patch-telegram-stats.py):
1522        // the counters live on globalThis so neither shared module imports the other,
1523        // and an actor without the patched helper simply carries none of these keys.
1524        // They name a Telegram flood's SENDER — the 12-line lastLog tail only ever
1525        // showed end-of-run victims, which is why the 2026-09-21 and 2026-10-08
1526        // floods had no visible source until the sender was found by hand.
1527        const tg = (globalThis as { __telegramStats?: Record<string, number> }).__telegramStats;
1528        const tgFields = tg ? {
1529            tgAttempts: tg.attempts, tgCritical: tg.critical, tgUnrecognised: tg.unrecognised,
1530            tgSkipped: tg.skipped, tg429: tg.rate429, tgMaxRetryAfterSec: tg.maxRetryAfterSec,
1531        } : {};
1532        // `counts` goes in AFTER ...extra so a caller's own key can never lower
1533        // the three fields the zero-item sweep reads.
1534        const stored = await send('run-end', { status, ...fields, ...safeExtra, ...tgFields, ...zero, ...counts });
1535        // This run has its run-end now, so the platform must not send a second one
1536        // if an abort lands before the process is gone. Only once Axiom has stored
1537        // ours: a run-end that was lost leaves the platform's as the only record.
1538        if (stored) await dropAbortWebhook();
1539        // Mirror the counts into the run log too: for the owner's OWN runs the
1540        // log is readable via the API, so this is a second, independent record
1541        // of exactly what run-end reported.
1542        console.log(`[TELEMETRY] run-end status=${status} itemsPushed=${counts.itemsPushed} itemCount=${counts.itemCount} itemsProduced=${counts.itemsProduced} pushCounterLive=${state.pushCounterLive}`);
1543    } catch (e) {
1544        console.warn('[TELEMETRY] failed to send run-end (non-fatal):', (e as Error).message);
1545    }
1546}

src/lib/shardHints.ts

1/**
2 * Sitemap shard numbers (sitemap{N}.xml.gz) that held each jurisdiction, most URLs first.
3 * Built on 2026-10-30 from the 406 shards the actor samples (every 14th of 5676).
4 * Runs fetch these shards first and then fall back to the full stride scan, so a
5 * stale entry only costs a few wasted requests. Jurisdictions with fewer than 20
6 * URLs in a shard are left out.
7 */
8export const SHARD_HINTS: Record<string, number[]> = {
9    al: [1233, 1163],
10    au: [1919, 1905, 1891, 1877, 3501, 3515, 1863, 3487, 2605, 3151, 2437, 4593, 4649, 3543, 4033, 5279, 3459, 5587, 4789, 5461, 4495, 5391, 3473, 4481, 3445, 5013, 5601, 4509, 5195, 5125, 4369, 5573, 4803, 4439, 5209, 4677, 3277, 1947, 5265],
11    aw: [2241, 1723, 1387],
12    bb: [3137, 3277, 3221, 3067, 3347],
13    be: [1667, 1863, 2367, 5363, 5475, 5643, 3221, 5531, 2493, 5097, 5503, 4957, 5139, 5601, 4985, 5419, 4677, 5573],
14    bg: [3361, 3375],
15    bh: [1387, 1723, 1611, 1961, 1331, 1737, 1751, 1975, 2241, 2017],
16    bl: [4229, 4145, 4187, 4173, 4131, 5629, 4747, 5643],
17    bm: [1947, 1555, 2857, 1723, 1233, 1163, 1387, 1107, 1317, 1737],
18    bo: [3081, 3137],
19    br: [3585, 3599, 3613, 3627, 3669, 3683, 3697, 3711, 3725, 3739, 3753, 3767, 3571, 3655, 3557, 3641, 3795],
20    bs: [1527, 4201, 3333, 4089, 3277],
21    by: [3109, 3095, 4075, 4285, 4327, 4341, 4509, 3529, 4313, 3543, 4159, 4201, 3305],
22    bz: [4061, 4341, 4817, 4929],
23    ca: [421, 337, 1975, 2493, 351, 1947, 4509, 5237, 5475, 5377, 5531, 5503, 5349, 5265, 5335, 5559, 5363, 4327, 4313, 3935, 3543, 3781, 3333, 4285, 3305, 2857, 2871, 2647, 1387, 3319, 5209, 1611, 1373, 1625, 1527, 1751],
24    "ca_bc": [4873, 4845, 4915, 4901, 4887, 5209, 4929, 5153, 5251, 5489, 5503, 5671, 5573, 5629, 5657],
25    "ca_nb": [1933, 4047, 4033, 5657, 3403, 3067, 3207, 3277, 4285, 5265, 3333, 5167, 5545, 4327, 2955, 5139, 5153, 4929, 3137, 4495, 4369, 3221, 4817, 3081, 4383, 5251, 4733, 4663, 5237, 4775, 4691, 4859, 3347, 3305, 4523, 4341, 3235, 5573, 4355, 4481],
26    "ca_nl": [4033, 3137, 4047, 3403, 3067, 3333, 3207, 5503, 3081, 3221, 3277, 3305, 4733, 4341, 5013, 3319, 4285, 4817, 5363, 5587, 4859],
27    "ca_ns": [1331, 2283, 1387, 1359, 1527, 2101],
28    "ca_on": [5335, 5321, 5419, 5111, 5405, 5307, 5139, 5167, 5181, 5349, 5447, 5461, 4999, 5013, 5489, 5279, 5377, 5559, 5531, 5503, 5475, 5545, 5573, 5517, 5587, 5657, 5125, 5601],
29    "ca_pe": [2045, 1163, 3403, 3333, 3137, 2283, 3347, 3319, 3277, 3221, 3305],
30    "ca_qc": [1135, 1149, 1191, 1387, 2283, 2059, 1415, 2017, 1373, 2101],
31    ch: [2717, 2703, 4327, 4803, 3529, 4355, 3935, 4341, 4775, 3319, 3305, 4159, 4285, 5209, 4313, 2857, 5279, 3221, 3277, 4929, 5181, 5447, 5377, 4397, 4817, 4943, 3067, 4383, 5097, 3151, 5111, 4439, 3347, 5265, 4999, 5293, 5013, 5125, 5251, 5195],
32    cw: [4075, 4341, 3221, 5503, 4313, 5265, 5363, 5139, 4663, 3305, 4159, 4257, 4593, 4929, 5209, 5293, 4733, 5153, 5181, 4957, 5545, 5587, 3319, 4243, 4201, 4691, 4775, 5461, 5643, 4649],
33    cy: [1989, 1821, 3963, 3529, 3137, 3151, 5503, 4733, 3067, 5363, 4341, 5531, 4495, 4327, 4817, 5265, 3221, 4803, 4369, 4775, 5237, 4859, 4929, 4999, 5545, 5013, 5461, 5559, 5251, 5097, 2353, 5601, 5587, 5181, 5335, 3207, 4313, 5475, 2367, 5279],
34    cz: [4467, 4453, 5307],
35    de: [3809, 3879, 3907, 3823, 3837, 3865, 3921, 3893, 3851, 4481, 4341, 4327, 4495, 4369, 4803, 4663, 4761, 4691, 5545, 4383, 5293, 4593, 4439, 4775, 4747, 4789, 4817, 4649, 4355, 5573, 5419, 4537, 4957, 4509, 4733, 4551, 5013, 4999, 5559, 5601],
36    dk: [1401, 2381, 2395, 4089, 3543, 4971, 3991, 4509, 5671, 4159, 5349, 5139, 1961, 4215, 5293, 1611, 1947, 2269, 1527, 1625, 1821, 2059, 2241, 1975, 2101, 1989, 1513, 2017, 4635, 2857, 4593, 3011, 4201],
37    do: [1275, 2367, 4033, 3053, 3137, 4159, 1723, 3277, 4103, 3067, 4495, 1387, 1611, 1751, 4383, 3081, 4341, 2493, 3221, 3263, 1359, 1527, 1737, 4327, 2689, 3319, 1331, 3151, 4355, 2605, 1317, 4481, 4089, 4215, 4271, 4201, 4313, 4173, 4257, 2535],
38    es: [379, 449, 477, 393, 337, 323, 351, 421, 407, 463, 365],
39    fi: [2395, 4047, 2381, 3963, 4089, 3333, 1961, 4285, 1555, 1723, 1527, 1611, 4313, 3053, 4327, 1751, 4159, 3137, 1947, 2857, 3081, 3151, 3221, 1737, 1975, 2689, 3277, 4733, 2059, 4355, 4243, 4537, 5111, 5461, 5531, 4831, 4999, 5363, 5349, 5503],
40    fr: [3039, 2941, 2983, 2955, 2969, 2927, 2899, 2885, 2913, 2997, 4243, 3207, 3011, 4145, 3025, 4131, 4187, 4173, 4229, 5629, 5615, 4747, 4271, 4257, 5643, 4691, 3305, 4313, 4999, 5657, 5671, 4159, 4761, 4341, 5111, 5181, 5237, 5209, 5195, 5223],
41    gb: [1, 15, 29, 43, 57, 71, 85, 491, 225, 4677, 267, 253, 281, 239, 211, 5503, 1961, 1107, 1387, 4327, 4313, 5209, 2857, 4285, 4859, 1751, 3137, 3963, 4929, 4341, 2647, 1611, 3333, 2493, 3305, 4775, 2689, 1723, 1331, 1555],
42    gf: [4229, 4187, 4145, 4173, 4131, 5615, 5643, 5629, 4257, 4747, 4271, 4691, 4243, 4159, 5657, 4313, 5097],
43    gg: [3935, 4397, 4691, 3529, 4285, 4327, 5013, 3305, 3221],
44    gi: [183],
45    gl: [897],
46    gp: [4229, 4145, 4187, 4173, 4131, 5629, 4747, 5615, 5643, 4271, 4691, 4257, 4243, 4159, 5657, 5671, 4313, 5097],
47    gr: [3193, 3165, 3179, 4019, 3431, 3459, 3305, 3333, 3319],
48    hk: [1779, 1765, 1793, 1807, 2157, 2521, 3067, 3305, 3221, 4159, 4103, 3319, 4285, 3151, 3277, 2689, 2857, 2647, 2661, 3137, 3347, 2451, 4257, 4089, 3781, 2535],
49    hr: [3403, 3221, 2143, 1275],
50    ie: [463, 477, 5503, 4047, 4257, 2493, 4355, 3333, 2857, 1961, 3081, 5671, 3137, 3963, 1387, 3067, 1723, 995, 3305, 1611, 1331, 2437, 5601, 2059, 4943, 5363, 4859, 4929, 1947, 2647, 3347, 5531, 5559, 3781, 4159, 3277, 3543, 4187, 5251, 5153],
51    il: [2507, 3137, 5447, 5139, 5153, 2521, 2647, 2549, 5167, 5125, 5307, 5293, 5489, 5545, 5559, 5349, 5237, 5097, 5041, 5321, 3277, 5363],
52    im: [183, 197, 547, 2437, 1331, 379, 4201, 421, 3333, 4089, 3277, 5573, 1233, 2857, 3137, 3221, 4355, 1219, 1107, 3081, 3067, 3151, 1289, 1611, 1751, 2647, 4285, 4663, 4733, 4985, 5671, 757, 1163, 5251, 4803, 4341],
53    in: [365, 1079, 1555, 4355, 2241, 4033, 1723, 1387, 1751, 3403, 1331, 421, 1737, 4817, 4929, 3137, 3347, 2521, 4859, 3333, 4663, 1233, 3277, 4327, 3179, 3221, 3305, 5167, 3067, 4313, 3081, 4831, 4635, 2689, 4649, 5097, 1373, 4971, 1611, 1961],
54    ir: [3445, 3473, 3459, 3487],
55    is: [197, 1331, 1387, 547, 3305, 2857, 3319, 3221, 379, 3151, 421, 841, 3277, 1107],
56    je: [155, 1163, 4033, 4159, 3431, 4201, 3305, 4103, 2857, 4341, 1723, 1387, 1947, 2283, 1233, 1527, 1289, 2493, 4271, 2689, 4481, 197, 2367, 2423, 2535],
57    jm: [1387, 1107, 1317, 1723, 1233, 1359, 1961, 1163, 1331, 1443, 1975, 1611, 1527],
58    jp: [2787, 2801, 2829, 2773, 2745, 2843, 2759, 2815, 3333, 4089, 3221, 4733, 3151, 4285, 3067, 4005, 2857, 4761, 4663, 5461, 5671, 4355, 5573, 5293, 5363, 4327, 4383, 5279, 4509, 5447, 4313, 5097, 4929, 5265, 5587, 5195, 5013, 4859, 5125, 4257],
59    kh: [3977, 4005, 4075, 4369, 4159, 4201, 3333, 4215, 4229],
60    li: [1387, 1163, 5321, 1331, 2871],
61    lu: [99, 197, 2451, 1289, 1555, 1751, 2857, 1723, 1317, 1387, 1737, 3081, 1611, 3333, 2493, 2647, 3137, 3305, 3277, 3543, 2437, 2059, 3221, 2689, 2521, 2423, 3319, 3557, 1863, 3347, 1625, 3151, 3389, 2283, 2465, 2535, 3165, 2017, 3431, 3179],
62    lv: [3053, 4201, 4089, 2465, 3081, 3277, 3137, 3151, 1751, 2059, 3221, 2689, 1723, 5363, 1737, 5503, 4285, 4271, 5601, 3067, 5671, 2647, 5461, 5097, 5167, 4341, 5587, 5545, 5181, 5559, 1821, 4481, 5573, 4775, 4733, 4803, 2857, 1933, 4957, 5265],
63    md: [3781],
64    me: [1359, 1723, 1387, 3137, 1751, 1947, 3319, 3277, 3221, 1639, 1611, 1933, 3151, 1737],
65    mf: [4229, 4173, 4187, 4145, 4131, 5629, 4257, 5615],
66    mm: [3067, 2521],
67    mq: [4229, 4187, 4173, 4145, 4131, 5643, 4271, 5629, 4747, 4243, 5615, 4257, 4691, 4159, 5657, 5055, 4313, 5069, 5097, 5671],
68    mt: [3053, 4089, 4201, 4285, 1107, 3151, 2857, 1331, 2647, 2493, 3081, 4663, 4733, 3221, 4985, 2563, 1233, 3165, 1359, 4817, 4999, 4859, 4481, 4747, 4761, 4929, 1163, 4369, 1387, 4229, 5125, 5111, 575, 5237, 5013, 5153, 5251, 1289],
69    mu: [1723, 3277, 3347, 3221, 3319, 1163, 2493, 1751, 2241, 2647, 3137, 3151, 1611, 2857, 2521, 1737, 3067, 2535, 1107],
70    mx: [1051, 1331, 1065, 1387, 1359, 1527, 1947, 1961, 1723, 1751, 1611, 1737, 1653, 1681, 1625, 1821],
71    my: [2619, 2633, 2647, 3781, 3277, 4159, 3221, 3305, 4103, 3347, 3151, 3319, 2857, 2689, 3137, 2731, 3067, 4201, 4089],
72    nl: [113, 127, 141, 547, 1989, 4201, 155, 3333, 2423, 2199, 5167, 4285, 3305, 4985, 4971, 2017, 5251, 2059, 2437, 4929, 5363, 4313, 4859, 4327, 3207, 2241, 4803, 4999, 2101, 4369, 5265, 2409, 5391, 5237, 4383, 4817, 4943, 5209, 4831, 4355],
73    no: [2115, 2101, 701, 715, 3977, 3963, 3529, 2185, 2535, 3067, 5293, 3151, 4733, 4383, 5097, 4691, 5237, 3319, 2857, 4537, 3221, 4369, 1331, 4677, 4985, 5153, 3277, 1387, 4775, 5209, 4593, 4957, 4859, 3137, 4439, 2647, 1233, 1163, 4509, 1961],
74    nz: [407, 393, 3543, 4201, 3305, 4103, 4313, 4285, 5363, 4495, 3137, 4327, 5391, 5293, 2493, 1611, 1961, 4271, 4257, 1331, 1387, 4369, 3067, 2857, 4775, 1737, 1723, 4663, 1751, 2521, 2437, 1555, 4509, 1583, 421, 3081, 4593, 4355, 1947, 4383],
75    pa: [435, 4089, 3963, 3515, 2647, 4383, 3151, 3081, 3137, 2241, 3067, 2437, 4509, 2283, 2493, 4327, 4313, 4495, 4355, 4439],
76    pk: [3963, 4089, 3137, 3081, 4341, 4257, 2241, 2857, 4327, 3277, 4271, 3151, 4229, 1275, 2535, 3221, 2059, 1233, 4285, 4313, 2017, 1387, 3067, 1723, 1555, 1961, 1975, 1331, 4369, 1163, 1737, 1359, 1611, 1751, 2647, 1317, 2493, 2521],
77    pl: [687, 1233, 1163],
78    pm: [4131],
79    pr: [1457, 1471, 5265, 5545, 5251, 4159, 5671, 2493, 5503, 5209, 5573, 3067, 4775, 3221, 5531, 5167, 5013, 4859, 5363, 4803, 5335, 4103, 4663, 4999, 4733, 5097, 4929, 5601, 3137, 4593, 3347, 4817, 5125, 5559, 4691, 5489, 5405, 5657, 5447, 5279],
80    re: [4229, 4187, 4145, 5657, 4173, 4131, 5615, 5629, 4747, 4691, 4271, 4243, 4257, 5643, 4159, 4313, 5097, 5671, 4341],
81    ro: [1597, 1569, 2675, 1583, 2661, 1625, 1639, 2689],
82    rw: [1359],
83    se: [1121, 1737, 1163, 2241, 1751, 1933, 1835, 1947, 5349, 1723, 2367, 2493, 3277, 1387, 3319, 2689, 3221, 3137, 2465, 2521, 2101, 3067, 1233, 1611, 3151, 2647, 2059, 1961, 2017, 1625, 2535, 1317, 2857, 1513, 1331],
84    sg: [3123, 1303, 2535, 239, 4033, 197, 3067, 2857, 5489, 5279, 4103, 5139, 5195, 3081],
85    si: [295, 3053, 4033, 1961, 5657, 1947, 1387, 3067, 547, 1975, 3277, 3137, 1723, 3347, 5251, 1751, 2689, 2283, 4103, 421, 2535, 3081, 2017, 4159, 5503, 2493, 4495, 4201, 3319, 2143, 575, 1331, 4313, 4369, 5363, 5559, 4691, 4831, 5237, 379],
86    sk: [4341, 3067, 4355, 3151, 4537, 3935, 4159, 4271, 4103],
87    th: [1247, 1261, 4047, 1611, 2269, 1331, 1387, 2297, 1737, 2857, 3067, 3221, 1317, 3137, 1625, 2605, 2493, 2535, 2689, 3151, 1681, 2647, 1653, 1723, 2521],
88    tj: [1933, 2059, 2437],
89    tn: [1947, 1471, 3067, 3781, 2731, 3151, 3347, 3277, 3305, 3137, 3221, 2689, 3319],
90    ua: [3249, 3235, 3263, 3977, 4005, 3501, 3333, 4383, 4215, 4341, 4201, 4733, 4593, 4481, 4369, 4229, 4663, 4537, 4313, 4691, 4817, 4285, 4761],
91    ug: [3347, 1653, 4537, 3977, 4369, 4159, 4131, 2563, 4145, 4341, 4271, 4201, 4383, 4327, 4607, 4313, 4257, 4229, 2843, 2689, 2647, 1933, 4285, 4635, 2535],
92    "us_ak": [4481, 1233, 1961, 4285, 4733, 5503, 1723, 5671, 4313, 5559, 5363, 5153, 379, 4859, 1975, 5601, 4929, 1751, 547, 4803, 5475, 1947, 2017, 1387, 1163, 5545, 5573, 2493, 4341, 5111, 1317, 4691, 1737, 4257, 5489, 1611, 4271, 4761, 5461, 4663],
93    "us_al": [2031, 2857, 5153, 4005, 5363, 3529, 3375, 2689, 4663, 5503, 4341, 5671, 2493, 4047, 5181, 4327, 4733, 4775, 4929, 4859, 4803, 5545, 5573, 4159, 4131, 4957, 4369, 4817, 5531, 4439, 4649, 5097, 5209, 4761, 4691, 5559, 4971, 4943, 4313, 4831],
94    "us_ar": [2283, 4369, 5419, 3067, 3403, 3151, 3333, 2437, 2521, 4957, 4481, 4803, 4859, 5153, 5489, 5559, 5503, 5545, 4663, 4593, 4691, 4817, 4971, 5573, 4929, 4733, 4985, 4775, 5531, 5475, 4495, 4831, 5587, 4537, 4761, 5629, 4943, 5111, 5657, 4747],
95    "us_az": [813, 4579, 2871, 897, 2647, 2465, 5265, 2535, 967, 5573, 5279, 4971, 5587, 827, 5489, 5461, 1611, 4663, 883, 1723, 5601, 5475, 1387, 5671, 4957, 841, 2059, 4803, 2017, 4999, 5447, 5097, 1625, 1317, 1233, 1107, 1653, 1163, 4635],
96    "us_ca": [4117, 603, 617, 2353, 589, 575, 1373, 5517, 4565, 2325, 4943, 4215, 561, 2339, 3319, 4593, 4649, 4047, 4775, 5587, 4005, 5125, 4635, 4733, 5601, 5097, 5293, 1051, 3347, 1317, 5419, 5111, 5363, 1723, 1961, 4327, 1331, 1387, 1751, 4075],
97    "us_co": [2171, 3053, 2227, 3431, 2213, 3081, 2199, 4215, 3781, 2185, 4355, 5125, 4005, 3277, 3543, 5671, 2535, 4159, 4285, 4859, 4663, 5545, 4733, 5573, 5139, 4089, 5293, 4761, 4957, 5097, 5489, 4201, 4691, 4985, 4775, 4313, 5419, 4439, 5657, 5391],
98    "us_ct": [799, 4817, 5293, 2689, 3221, 5671, 4761, 4537, 4733, 5475, 4033, 5363, 5559, 5503, 4495, 5587, 4327, 5111, 5391, 4481, 4929, 4159, 5531, 5097, 5545, 5573, 5349, 4341, 4313, 4201, 5489, 5447, 5195, 5181, 2605, 4285, 4075, 4369, 4257, 4943],
99    "us_dc": [197, 2311, 4481, 3333, 2857, 2689, 3529, 2591, 5503, 4663, 5125, 4075, 4285, 4495, 4341, 4929, 4733, 5167, 5671, 5461, 4159, 5601, 5363, 4761, 4957, 4327, 5279, 4691, 4271, 5587, 4313, 5573, 4649, 5559, 4425, 4047, 4999, 4537, 4201, 4439],
100    "us_de": [673, 2255, 4705, 2269, 2185, 2213, 2199, 2227, 5447, 5587, 3067, 4971, 2171, 337],
101    "us_fl": [953, 981, 1037, 1009, 1023, 995, 911, 841, 827, 967, 897, 1317, 1289, 883, 925, 939, 4859, 3081, 869, 4943, 3963, 855, 4817, 5195, 4369, 4509, 4929, 4733, 3221, 4341, 1387, 1961, 5573, 5531, 5601, 3137, 1555, 4285, 3333, 4999],
102    "us_ga": [4719, 645, 659, 631, 2311, 2339, 5391, 5153, 5181, 5167, 5265, 5489, 5377, 4761, 5559, 5615, 5307, 5657, 4957, 4635, 2689, 3319, 2493, 2605, 4033, 2325, 4159, 4369, 4075, 4089, 4327, 4131, 4285, 4495, 4201, 4341, 4313, 4355],
103    "us_hi": [1639, 4047, 5293, 5503, 5195, 4663, 4733, 5279, 5125, 4957, 4803, 4691, 5111, 5559, 4005, 4929, 5545, 4859, 5097, 5251, 5209, 4999, 5629, 5139, 4649, 5489, 4593, 4761, 4901, 5153, 4985, 5181, 4817, 5307, 4971, 4033, 4747, 5335, 5377, 4775],
104    "us_ia": [1065, 4369, 4355, 4285, 2017, 2213, 5321, 1275, 1723, 1233, 5125, 5503, 1387, 5097, 5209, 4747, 1751, 5251, 5013, 5181, 5657, 4999, 4775, 5573, 5265, 4859, 4929, 4663, 1107, 5195, 5531, 5279, 1625, 1611, 1163, 5601, 4649, 5293, 4761, 4803],
105    "us_id": [5489, 5671, 4999, 4859, 4971, 1723, 5111, 1961, 4943, 1387, 2647, 4957, 4523, 4537, 5125, 1317, 5097, 4831, 5139, 4775, 4929, 1947, 4495, 4663, 1331, 4593, 4985, 1611, 2017, 5251, 1737, 4635, 1849, 2059, 5209, 5279, 1107, 1625, 5195, 4649],
106    "us_il": [5083, 5027, 5055, 5069, 5041, 5321, 5153, 5237, 5139, 5125, 5307, 5391, 5629, 5545, 5265, 5671, 5601, 5503, 5279, 5573, 5251, 5531],
107    "us_in": [2003, 4523, 2451, 2465, 5209, 5643, 4663, 4761, 2689],
108    "us_ks": [1709, 4103, 2437, 5587, 3347, 5139, 5419, 3319, 3305, 4859, 5125, 4943, 4887, 4313, 5503, 5111, 5573, 5097, 5181, 4075, 5531, 4341, 4355, 5559, 5293, 5251, 4327, 5545, 4005, 5167, 4201, 4929, 5013, 4663, 4593, 4957, 5153, 5223, 5195, 5279],
109    "us_ky": [2017, 2031, 2493, 3319, 4019, 5363, 3207, 5671, 5503, 4649, 4481, 5461, 4803, 5587, 4663, 5167, 4859, 5545, 5559, 3543, 5181, 4341, 4327, 5489, 4775, 4929, 4733, 4957, 5279, 4047, 5265, 5391, 5153, 4761, 5097, 4313, 5447, 5573, 5013, 5125],
110    "us_la": [883, 2465, 869, 2521, 855, 3781, 4075, 4803, 3515, 5153, 3305, 5251, 3347, 3319, 4817, 4313, 4047, 4971, 4929, 5601, 3221, 5097, 5587, 4747, 4285, 2535, 2689, 2087, 2647],
111    "us_ma": [771, 785, 4005, 3529, 4649, 5139, 4593, 5153, 4859, 5237, 5265, 4929, 5559, 5587, 5377, 5573, 5293, 4999, 5545, 4761, 4509, 4341, 4313, 4327, 4131, 4159, 4495, 4369, 4439, 4537, 4201, 4635, 4173, 5475, 4383, 4355, 4481, 4047],
112    "us_md": [4019, 939, 925, 4985, 4663, 4775, 4635, 2115, 2689, 4201, 4159, 4187],
113    "us_me": [5671, 4481, 2493, 2689, 2857, 5363, 4733, 3067, 5139, 4677, 5615, 5153, 4691, 5097, 4649, 5013, 5489, 5559, 5293, 5657, 4075, 4439, 4271, 4285, 4495, 4313, 4257, 4159, 4509, 4383, 4537, 4355, 4369, 4047, 4201],
114    "us_mi": [169, 4299, 1695, 1681, 4985, 5475, 5307, 2059, 5657, 3221, 2647, 5293, 5377, 1961, 4495, 5237, 2521, 1723, 2437, 5391, 5265, 197, 1737, 2535, 5363, 4663, 4327, 4313, 2605, 4355, 5125, 1275, 5573, 5671, 183, 1107, 1233, 2689, 5503, 1387],
115    "us_mn": [2045, 4537, 2059, 4957, 2493, 5195, 4733, 4789, 5013, 5097, 5125, 5279, 5293, 5657, 5643],
116    "us_mo": [4397, 323, 351, 281, 253, 267, 295, 239, 4663, 4761, 5139, 4495, 4593, 1611, 5237, 5293, 5251, 5559, 4957, 5573, 5545, 1275, 5125, 1107, 5531, 5475, 1233, 4999, 4929, 1331, 2465, 4537, 1555, 2647, 1387, 1079, 449, 1317, 1163, 1289],
117    "us_ms": [757, 3137, 3529, 3319, 3221, 3277, 1513, 2017, 2521, 2493, 4341, 4047, 4313, 4327, 4285, 4691, 2535, 4033, 4761, 1723, 4663, 1611, 5671, 4537, 4929, 4775, 5377, 4817, 4859, 4999, 4733, 5013, 5587, 4957, 4369, 5279, 4803, 1527, 5209, 5125],
118    "us_mt": [5405, 2493, 4047, 5601, 3277, 3221, 3305, 5293, 3319, 5321, 5335, 4999, 4929, 4663, 5097, 4775, 5125, 4649, 5013, 4971, 5111, 4635, 4957, 4831, 4537, 4985, 4803, 4747, 4943, 4761, 4593, 4789, 4691],
119    "us_nc": [1849, 1835, 1821, 2325, 4481, 5181, 5377, 5251, 5013, 5391, 5447, 5097, 2493, 4733, 4341, 4761, 4663, 3263, 4313, 4327, 5657, 4257, 4775, 4691, 4635, 4495, 4677, 4509, 4369, 3319, 4159, 4383, 4173, 4201, 4271, 4355, 4593, 4537, 4747, 2311],
120    "us_nd": [2241, 4411, 4775, 5293, 2605, 5139, 5013, 4481, 5363, 4999, 5545, 5097, 5349, 5671, 5503, 5279, 5153, 5265, 5209, 5377, 5559, 5125, 5601, 5657, 5251, 5181, 5489, 5587, 5391, 5573, 4831, 5195, 5335, 5167, 5447],
121    "us_ne": [2423, 2871, 4635, 3375, 5153, 3529, 5125, 5139, 5391, 5195, 5461, 5363, 5279, 5251, 5293, 5013, 5097, 5657],
122    "us_nh": [4271, 5377, 5559, 5503, 2605, 4285, 4733, 5601, 4313, 4495, 5629, 4663, 5573, 4691, 5657, 5615, 4635, 5237, 5461, 5517, 4593, 5447],
123    "us_nj": [1093, 2479, 3291, 2087, 1233, 1107, 1975, 5349, 1163, 5251, 1415, 3347, 1289, 4075, 1317, 1751, 2059, 4285, 1961, 4537, 1849, 5671, 4663, 5125, 5573, 1723, 5503, 2857, 4775, 2647, 4159, 4817, 4733, 5391, 5587, 4957, 5559, 4803, 1947, 5265],
124    "us_nm": [5237, 4817, 4747, 3151, 2437, 1723, 1611, 1751, 1737, 1653, 1821],
125    "us_nv": [2143, 2129, 4943, 2493, 5237, 5181, 5167, 5405, 4999, 5265, 5335, 5559, 5489, 4775, 4733, 4761, 4663, 5573, 5629, 5657, 4537, 4747, 5531, 4691, 5587, 5601, 4789, 4593, 4649, 5461, 4047],
126    "us_ny": [1485, 1429, 1499, 1443, 1513, 1415, 1527, 1471, 5195, 3529, 1457, 5461, 5363, 5013, 5391, 4831, 5097, 5237, 4971, 1961, 1555, 5657, 2689, 1723, 1751, 4957, 1737, 1975, 2493, 1611, 2647, 1947, 2605, 2395, 2059, 2269, 1625, 2017, 2101, 2367],
127    "us_oh": [505, 533, 519, 4341, 1751, 4327, 3347, 5489, 4775, 4803, 4789, 5223, 5125, 4971, 5601, 2857, 4635, 5545, 4215, 4075, 5111, 3179, 1975, 1961, 1107, 1163, 1233, 4159, 1387, 2647, 4537, 1317, 1331, 2017, 1947, 4271, 4593, 4495, 4201, 4621],
128    "us_ok": [2297, 869, 855, 5377, 3025, 4481, 3277, 4313, 2521, 2689, 4327, 2647, 4355, 5363, 4817, 5671, 4285, 4733, 4929, 5573, 5349, 5503, 5335, 4425, 4999, 5559, 5587, 5265, 4495, 5545, 4509, 5447, 5489, 5013, 5097, 4649, 5153, 5181, 4971, 5111],
129    "us_or": [1345, 1359, 3991, 2283, 4635, 5321, 2437, 5139, 4439, 5545, 5559, 4733, 4075, 4369, 4257, 4215, 4327, 4047, 4005, 4159, 5629, 4285, 4551, 1387, 5573, 5503, 5363, 5671],
130    "us_pa": [729, 1541, 743, 5433, 3389, 4831, 3431, 715, 701, 3053, 5671, 3977, 3137, 5615, 5657, 2647, 5489, 5643, 1723, 1751, 4999, 1975, 1961, 1737, 3543, 4971, 3081, 1555, 4075, 1611, 1947, 2017, 4047, 4201, 4159, 4131, 2059, 1625, 2101, 4033],
131    "us_ri": [3067, 5139, 4495, 5293, 5489, 4985, 5153, 4691, 4733, 5545, 5559, 4327, 4313, 5657, 4285, 4635, 2647, 1387, 2577],
132    "us_sc": [4607, 4621, 4635, 4817, 5279, 4761, 5237],
133    "us_sd": [2311, 5293, 5153, 5419, 5139, 5363, 4817, 4733, 4775, 5251, 5489, 5097, 4593, 5447, 5573, 5643, 2367, 2605, 2493, 2325],
134    "us_tn": [519, 4537, 4649, 5223, 5643, 5265, 5293, 3389, 3277, 575, 3221, 1205, 1163, 3543, 2605, 1317, 4075, 1233, 4327, 4313, 1387, 4257, 4005, 4159, 1331, 4341, 4285, 4201, 4243, 4271, 1289, 4089, 1527, 4033, 4019, 4369, 1023, 4103, 4355, 4047],
135    "us_tx": [3417, 2549, 2731, 2591, 4551, 2577, 2563, 3935, 3403, 4439, 4383, 3977, 4495, 4565, 4789, 5559, 3389, 5475, 5503, 3963, 5573, 4663, 4733, 5153, 5461, 5363, 4999, 4775, 5671, 5237, 2605, 4929, 5531, 5601, 4691, 5321, 4817, 5545, 5657, 5167],
136    "us_ut": [2073, 5223, 2689, 3781, 3277, 3991, 4201, 4285, 4159, 4215, 4229, 4257, 4271, 4187],
137    "us_va": [4425, 4411, 1653, 1625, 4509, 3277, 4047, 5139, 4593, 5489, 5671, 5251, 5293, 4733, 4691, 5307, 5013, 5125, 5419, 5097, 4103, 5657, 2367, 2647, 2493, 2535, 2423, 2437],
138    "us_vt": [855, 3333, 2857, 5013, 5209, 4929, 3529, 4509, 4663, 4341, 4859, 4495, 4999, 5335, 5251, 5181, 4075, 4831, 4327, 4481, 4355, 4775, 4593, 4313, 4369, 5293, 4159, 4383, 4439, 1107, 1387, 5377, 5391, 1289, 4677, 4691, 5363, 2689, 4047, 4537],
139    "us_wa": [309, 561, 4159, 4075, 925, 5265, 5503, 4733, 1387, 1961, 4663, 5363, 5573, 5559, 4999, 5601, 1233, 1611, 4005, 1751, 4397, 4341, 4957, 4859, 5209, 5489, 4831, 1737, 4383, 1975, 4803, 5097, 5237, 4355, 4817, 4929, 4971, 1947, 5349, 4313],
140    "us_wi": [2409, 2423, 2871, 4957, 4355, 4005, 5153, 4761, 5237, 5363, 5265, 5111, 4733, 5293, 4929, 5657, 5587, 5391, 3529, 4047, 5461, 5573, 5139, 5531, 5279, 5349, 5503, 5321, 4999, 5601, 5041, 5167],
141    "us_wv": [3963, 3151, 3333, 2437, 4313, 5363, 1947, 1961, 4159, 1723, 4341, 5503, 4355, 1751, 4369, 1611, 5461, 5531, 4327, 5489, 5097, 5265, 5013, 4775, 4663, 4285, 4929, 5601, 1737, 4201, 4257, 4859, 5125, 4733, 4761, 5237, 4999, 5251, 5139, 5643],
142    "us_wy": [211, 5531, 5545, 4789, 4859, 4803, 4481, 3277, 4075, 4341, 4159, 4369, 4355, 4047, 4327, 1387, 1527, 4383, 4593, 2367, 1317, 1947, 4005, 1961, 547, 4635, 1975, 4411, 4649, 4537, 1163, 1233, 1331, 2017, 2535, 4173, 4201, 2451, 4215, 2493],
143    vn: [3949, 3963, 1723],
144    yt: [4229, 5629, 4145, 4271, 5615, 5643, 4747, 4173, 4257, 4131, 4187, 4691],
145    za: [1177, 1219, 1205, 1191],
146};

src/lib/telegram.ts

1import { Stream } from 'stream';
2import { promisify } from 'util';
3
4import TelegramBot from 'node-telegram-bot-api';
5
6// --- BEGIN telegram crash guard (auto-injected) ---
7// node-telegram-bot-api (via bluebird) and telegraf can surface a Telegram HTTP error (e.g. a 429 on
8// the shared bot token) as a rejection on an INTERNAL promise that escapes any try/catch around our
9// notify calls, which Node default --unhandled-rejections=throw turns into a process-killing
10// uncaughtException BEFORE the scrape runs. A non-critical notification must never crash the actor,
11// so swallow Telegram-origin errors here and let everything else crash as normal. Registered once
12// (idempotent) at module load, which happens before any notify call because callers import this module.
13// crash-guard-net-v2 (2026-09-21): also swallow transient TLS/proxy/transport-stream errors
14// (ERR_SSL_WRONG_VERSION_NUMBER, ERR_SSL_BAD_RECORD_TYPE, ECONNRESET, TransformError, …).
15// Those leak as uncaughtException after the request already settled/retried and must not
16// kill a healthy crawl (Stepstone 0UtZX6uR32AmxqovH, Allegro iUImqxLXFKh3pMVcN).
17{
18    const G = globalThis as unknown as { __telegramCrashGuardInstalled?: boolean };
19    if (!G.__telegramCrashGuardInstalled) {
20        G.__telegramCrashGuardInstalled = true;
21        const isTelegramError = (e: unknown): boolean => {
22            const err = e as { code?: string; message?: string; stack?: string; response?: { request?: { href?: string } } };
23            const s = String(err?.stack ?? '');
24            return err?.code === 'ETELEGRAM'
25                || /node-telegram-bot-api|telegraf/.test(s)
26                || /api\.telegram\.org/i.test(String(err?.message ?? '') + s + String(err?.response?.request?.href ?? ''));
27        };
28        const isTransientNetError = (e: unknown): boolean => {
29            const err = e as { code?: string; message?: string; stack?: string; name?: string; reason?: string };
30            const code = String(err?.code ?? '');
31            const blob = `${err?.message ?? ''} ${err?.stack ?? ''} ${err?.name ?? ''} ${err?.reason ?? ''}`;
32            return /^(ERR_SSL_|EPROTO|ECONNRESET|ECONNREFUSED|ECONNABORTED|EPIPE|ETIMEDOUT|ENOTFOUND|EAI_AGAIN|UND_ERR_|ERR_PROXY_|ERR_STREAM_PREMATURE_CLOSE|ERR_HTTP2_|EMFILE|ENETUNREACH|EHOSTUNREACH|Z_BUF_ERROR)/.test(code)
33                || /bad record type|wrong version number|socket hang up|Client network socket disconnected|SSL routines|\btls13?_|\bssl3?_|read ECONNRESET|write EPROTO|tunneling socket|Proxy response|other side closed|premature close|TransformError|ReadError|got-scraping/i.test(blob)
34                || err?.name === 'TransformError'
35                || err?.name === 'ReadError';
36        };
37        const isRecoverable = (e: unknown): boolean => isTelegramError(e) || isTransientNetError(e);
38        process.on('uncaughtException', (err) => {
39            if (isRecoverable(err)) { console.warn('[telegram-guard] swallowed recoverable uncaughtException:', (err as Error)?.message ?? err); return; }
40            console.error('[telegram-guard] fatal uncaughtException:', err);
41            process.exit(1);
42        });
43        process.on('unhandledRejection', (reason) => {
44            if (isRecoverable(reason)) { console.warn('[telegram-guard] swallowed recoverable unhandledRejection:', (reason as { message?: string })?.message ?? reason); return; }
45            console.error('[telegram-guard] fatal unhandledRejection:', reason);
46            process.exit(1);
47        });
48    }
49}
50// --- END telegram crash guard (auto-injected) ---
51
52const botToken = '6401107600:AAGXcsvYvUMAdRWcBZWtU9sKQ9I3eJ126jQ';
53const bot = new TelegramBot(botToken, { polling: false });
54
55// --- BEGIN alert relay (auto-injected) ---
56// alert-relay-v1 (2026-10-15): this bot is shared by ~600 actors and every run is a fresh
57// process, so nothing in here can see a flood. On 2026-10-08 one actor's 75k failed runs each
58// sent "Crawl failed", Telegram blocked the bot from 05:03 to 16:12 UTC, and every other actor's
59// failure alert in that span was dropped. sendMessage now goes to the alert relay first
60// (shared-telegram/relay), which keeps one budget per actor across all its runs and folds a
61// flood into a summary; uploads ask it first. A relay that is down, slow or refusing sends the
62// message straight to Telegram as before, so a relay outage never costs an alert.
63const ALERT_RELAY_URL = 'https://memo23-tg-relay.fly.dev';
64const ALERT_RELAY_TIMEOUT_MS = 3_000;
65type AlertRelayFetch = (url: string, init: Record<string, unknown>) => Promise<{ ok: boolean; json: () => Promise<unknown> }>;
66type AlertRelayAbort = new () => { signal: unknown; abort: () => void };
67async function postToAlertRelay(token: string, method: string, body: Record<string, unknown>): Promise<Record<string, unknown> | undefined> {
68    const g = globalThis as unknown as { fetch?: AlertRelayFetch; AbortController?: AlertRelayAbort };
69    if (!ALERT_RELAY_URL || typeof g.fetch !== 'function' || typeof g.AbortController !== 'function') return undefined;
70    const env = process.env;
71    const ac = new g.AbortController();
72    const timer = setTimeout(() => ac.abort(), ALERT_RELAY_TIMEOUT_MS);
73    try {
74        const res = await g.fetch(`${ALERT_RELAY_URL}/bot${token}/${method}`, {
75            method: 'POST',
76            headers: {
77                'content-type': 'application/json',
78                'x-alert-source': env.ACTOR_ID || env.APIFY_ACTOR_ID || '',
79                'x-alert-run': env.ACTOR_RUN_ID || env.APIFY_ACTOR_RUN_ID || '',
80                'x-alert-user': env.APIFY_USER_ID || '',
81                'x-alert-paying': env.APIFY_USER_IS_PAYING || '',
82            },
83            body: JSON.stringify(body),
84            signal: ac.signal,
85        });
86        if (!res.ok) return undefined;
87        const answer = (await res.json()) as { ok?: boolean; result?: unknown } | null;
88        return answer && answer.ok === true && answer.result && typeof answer.result === 'object' ? (answer.result as Record<string, unknown>) : undefined;
89    } catch {
90        return undefined;
91    } finally {
92        clearTimeout(timer);
93    }
94}
95function routeThroughAlertRelay(client: unknown, token: string): void {
96    // node-telegram-bot-api sends from the bot itself, telegraf from bot.telegram.
97    const target = ((client as { telegram?: unknown } | null)?.telegram ?? client) as Record<string, unknown> | null;
98    if (!token || !target || typeof target.sendMessage !== 'function') return;
99    const direct = (target.sendMessage as (...args: unknown[]) => Promise<unknown>).bind(target);
100    target.sendMessage = async (chatId: unknown, text: unknown, options?: unknown, ...rest: unknown[]): Promise<unknown> => {
101        const extra = options && typeof options === 'object' ? (options as Record<string, unknown>) : {};
102        const relayed = await postToAlertRelay(token, 'sendMessage', { ...extra, chat_id: chatId, text: String(text) });
103        return relayed ?? direct(chatId, text, options, ...rest);
104    };
105    for (const method of ['sendPhoto', 'sendDocument']) {
106        if (typeof target[method] !== 'function') continue;
107        const upload = (target[method] as (...args: unknown[]) => Promise<unknown>).bind(target);
108        target[method] = async (chatId: unknown, ...rest: unknown[]): Promise<unknown> => {
109            const verdict = await postToAlertRelay(token, 'relayAdmit', { chat_id: chatId, method });
110            if (verdict && verdict.admit === false) return { message_id: 0, relay: 'held back' };
111            return upload(chatId, ...rest);
112        };
113    }
114}
115routeThroughAlertRelay(bot, botToken);
116// --- END alert relay (auto-injected) ---
117const chatId = '473801635';
118
119// --- Settle-guarantee (portfolio-wide Telegram hang fix, 2026-08-07) ---
120// A Telegram API call can fail to settle AT ALL: node-telegram-bot-api can
121// surface a 429 as an uncaughtException (swallowed by the crash guard) while
122// the awaited send promise stays pending forever. That hung a customer run of
123// apify-indeed-cheerio at "Crawling started" until the 1h platform timeout
124// (run JSFVdfDyYZhXYfdbU, 2026-08-05) — the crawl never started, 0 results.
125// Race every Telegram call against a timer that RESOLVES (never rejects) so
126// callers are guaranteed an answer no matter how the library misbehaves.
127const SEND_HARD_TIMEOUT_MS = 15_000;
128const HARD_TIMEOUT: unique symbol = Symbol('telegram-hard-timeout');
129const raceWithHardTimeout = async <T>(promise: Promise<T>): Promise<T | typeof HARD_TIMEOUT> => {
130    let timer: NodeJS.Timeout | undefined;
131    const timeout = new Promise<typeof HARD_TIMEOUT>((resolve) => {
132        timer = setTimeout(() => resolve(HARD_TIMEOUT), SEND_HARD_TIMEOUT_MS);
133        timer.unref();
134    });
135    try {
136        return await Promise.race([promise, timeout]);
137    } finally {
138        clearTimeout(timer);
139    }
140};
141
142const sleep = promisify(setTimeout);
143const TELEGRAM_MAX_MESSAGE_LENGTH = 4000;
144const CHUNK_GAP_MS = 100;
145const DEFAULT_RETRY_DELAY_MS = 5000;
146const DEFAULT_MAX_RETRIES = 5;
147// A non-critical Telegram notification must never block the crawl. If Telegram
148// asks us to wait longer than this (429 retry_after can be hours), skip the
149// message instead of sleeping and stalling the actor.
150const MAX_RETRY_WAIT_MS = 15_000;
151
152const BRAND = 'S1JOBS SCRAPER';
153
154// --- Volume gate (portfolio-wide Telegram saturation fix, 2026-07-19) ---
155// ~382 actors share ONE bot token + ONE chat. At ~17.5k runs/day, routine
156// "crawling started" / "search finished" pings alone blow Telegram's ~20 msg/min
157// per-chat limit, and the resulting escalating 429s (retry_after up to hours)
158// caused FAILURE alerts to be dropped alongside the noise. Fix: deliver only
159// messages that look like failures/errors; silence routine lifecycle pings at
160// the source (a per-process token bucket can't help — each run is a fresh
161// process, so the flood is cross-run). Flip SEND_ROUTINE_NOTIFICATIONS=true to
162// restore the old chatty behaviour. Failures still flow because shouldDeliver()
163// defaults to SEND for anything not clearly routine.
164const SEND_ROUTINE_NOTIFICATIONS = false;
165const CRITICAL_RE = /error|fail|❌|🚨|❗|⚠️|exception|crash|\babort|timed?[ -]?out|blocked|denied|captcha|missing|could ?n[o']t/i;
166const ROUTINE_RE = /crawl(?:ing)? started|\bstarted\b|search finished|\bfinished\b|✅|resumed after migration|\[db-mode\]|progress:|delivered|\bcompleted\b|\brun done\b|\bdone —|\bdone -|\bno new\b|\bup to date\b/i;
167// A counter reading ZERO is not a failure signal. Strip such counters before the
168// critical test, otherwise routine summaries like "done — pushed=42 failed=0"
169// match /fail/ and defeat the gate (they are the highest-frequency message class:
170// one per run, ~17.5k runs/day).
171const ZERO_COUNTER_RE = /\b(?:fail\w*|error\w*|exception\w*|crash\w*)\s*[:=]\s*0\b|\b0\s+(?:fail\w*|error\w*|exception\w*|crash\w*)\b|\bno\s+(?:fail\w*|error\w*)\b/gi;
172
173// gate-input-v1 (2026-09-28): the lifecycle messages echo the run input, and input field
174// names or values (failOnErrorStatus, responseTimeout, a search for "error") matched
175// CRITICAL_RE, which delivered every routine "completed" ping. Judge the message
176// without that JSON block. Only a JSON value right after "Input:" is removed.
177const ECHOED_INPUT_RE = /(^|\n)[ \t]*input[ \t]*>*[ \t]*:?[ \t]*\n?[ \t]*(?=[{[])/i;
178function withoutEchoedInput(message: string): string {
179    const m = ECHOED_INPUT_RE.exec(message);
180    if (!m) return message;
181    const start = m.index + m[0].length;
182    const open = message[start];
183    const close = open === '[' ? ']' : '}';
184    let depth = 0;
185    let inStr = false;
186    for (let k = start; k < message.length; k++) {
187        const c = message[k];
188        if (inStr) {
189            if (c === '\\') k++;
190            else if (c === '"') inStr = false;
191            continue;
192        }
193        if (c === '"') inStr = true;
194        else if (c === open) depth++;
195        else if (c === close && --depth === 0) return message.slice(0, m.index) + '\n' + message.slice(k + 1);
196    }
197    return message.slice(0, m.index); // unbalanced (truncated) input: drop the rest
198}
199
200
201// --- Telegram send accounting ---
202// Counters live on globalThis so run-telemetry (a separate shared module) can read
203// them at run-end without either module importing the other. They make every sender
204// visible in Axiom (extra.tgAttempts / tg429 / ...) whether it pinged at run start or
205// run end — the 12-line lastLog tail only ever showed end-of-run victims.
206type TelegramStats = { attempts: number; critical: number; unrecognised: number; skipped: number; rate429: number; maxRetryAfterSec: number };
207const tgStats: TelegramStats = ((globalThis as { __telegramStats?: TelegramStats }).__telegramStats ??= {
208    attempts: 0, critical: 0, unrecognised: 0, skipped: 0, rate429: 0, maxRetryAfterSec: 0,
209});
210const noteRateLimit = (waitMs: number): void => {
211    tgStats.rate429 += 1;
212    tgStats.maxRetryAfterSec = Math.max(tgStats.maxRetryAfterSec, Math.round(waitMs / 1000));
213};
214
215// Send when the message looks critical, OR when it isn't recognisably routine
216// (unknown messages default to SEND so we never silently swallow a real alert).
217function shouldDeliver(message: string): boolean {
218    // TELEGRAM_DISABLED=1 is a hard kill switch for LOCAL/TEST runs only: it also
219    // suppresses failure alerts, so never set it on a platform actor. ~45 actors'
220    // main.ts already documented this flag while no helper implemented it.
221    if (process.env.TELEGRAM_DISABLED === '1') {
222        console.log('[T] TELEGRAM_DISABLED=1 — suppressing all Telegram output');
223        tgStats.skipped += 1;
224        return false;
225    }
226    if (SEND_ROUTINE_NOTIFICATIONS) { tgStats.attempts += 1; return true; }
227    const judged = withoutEchoedInput(message);
228    if (CRITICAL_RE.test(judged.replace(ZERO_COUNTER_RE, ' '))) { tgStats.attempts += 1; tgStats.critical += 1; return true; }
229    if (ROUTINE_RE.test(judged)) {
230        console.log(`[T] skipped routine notification (rate-hygiene): ${message.slice(0, 80).replace(/\n/g, ' ')}`);
231        tgStats.skipped += 1;
232        return false;
233    }
234    tgStats.attempts += 1;
235    tgStats.unrecognised += 1;
236    return true;
237}
238
239const splitMessage = (message: string, maxLength: number = TELEGRAM_MAX_MESSAGE_LENGTH): string[] => {
240    if (message.length <= maxLength) {
241        return [message];
242    }
243
244    const chunks: string[] = [];
245    let currentChunk = '';
246    const lines = message.split('\n');
247
248    for (const line of lines) {
249        if (line.length > maxLength) {
250            if (currentChunk) {
251                chunks.push(currentChunk.trim());
252                currentChunk = '';
253            }
254
255            const words = line.split(' ');
256            let wordChunk = '';
257
258            for (const word of words) {
259                if ((wordChunk + word + ' ').length > maxLength) {
260                    if (wordChunk) {
261                        chunks.push(wordChunk.trim());
262                        wordChunk = `${word} `;
263                    } else {
264                        chunks.push(`${word.substring(0, maxLength - 3)}...`);
265                    }
266                } else {
267                    wordChunk += `${word} `;
268                }
269            }
270
271            if (wordChunk) {
272                currentChunk = wordChunk;
273            }
274        } else if ((currentChunk + line + '\n').length > maxLength) {
275            if (currentChunk) {
276                chunks.push(currentChunk.trim());
277                currentChunk = `${line}\n`;
278            } else {
279                chunks.push(line);
280            }
281        } else {
282            currentChunk += `${line}\n`;
283        }
284    }
285
286    if (currentChunk.trim()) {
287        chunks.push(currentChunk.trim());
288    }
289
290    return chunks;
291};
292
293function apifyRunLinkForMessage(): string {
294    const id = process.env.ACTOR_RUN_ID?.trim();
295    return id ? `https://console.apify.com/actors/runs/${id}` : '(no ACTOR_RUN_ID — local run or env not injected)';
296}
297
298function telegramStatusCode(error: unknown): number | undefined {
299    const e = error as { response?: { statusCode?: number; body?: { error_code?: number } } };
300    return e?.response?.statusCode ?? e?.response?.body?.error_code;
301}
302
303function telegram429RetryAfterMs(error: unknown, fallbackMs: number): number {
304    const e = error as {
305        response?: { body?: { parameters?: { retry_after?: number } } };
306        parameters?: { retry_after?: number };
307    };
308    const retryAfter = e?.response?.body?.parameters?.retry_after ?? e?.parameters?.retry_after;
309    return retryAfter != null ? Number(retryAfter) * 1000 : fallbackMs;
310}
311
312async function sendMessageChunkWithRetry(
313    text: string,
314    options?: TelegramBot.SendMessageOptions,
315    retryDelayMs = DEFAULT_RETRY_DELAY_MS,
316    maxRetries = DEFAULT_MAX_RETRIES,
317): Promise<boolean> {
318    try {
319        const raced = await raceWithHardTimeout(bot.sendMessage(chatId, text, options));
320        if (raced === HARD_TIMEOUT) {
321            console.warn(`[T] sendMessage did not settle within ${SEND_HARD_TIMEOUT_MS / 1000}s — skipping message`);
322            return false;
323        }
324        return true;
325    } catch (error: unknown) {
326        const err = error as { code?: number | string; message?: string };
327        if (err.code === 'ETELEGRAM' && String(err.message ?? '').toLowerCase().includes('too long')) {
328            const truncated = `${text.slice(0, TELEGRAM_MAX_MESSAGE_LENGTH - 50)}... [truncated]`;
329            try {
330                const racedTrunc = await raceWithHardTimeout(bot.sendMessage(chatId, truncated, options));
331                if (racedTrunc === HARD_TIMEOUT) {
332                    console.warn(`[T] sendMessage (truncated) did not settle within ${SEND_HARD_TIMEOUT_MS / 1000}s — skipping`);
333                    return false;
334                }
335                return true;
336            } catch (e2: unknown) {
337                console.error('[T] sendMessage (truncated) failed:', (e2 as { message?: string })?.message ?? e2);
338                return false;
339            }
340        }
341        if (telegramStatusCode(error) === 429 && maxRetries > 0) {
342            const waitMs = telegram429RetryAfterMs(error, retryDelayMs);
343            if (waitMs > MAX_RETRY_WAIT_MS) {
344                noteRateLimit(waitMs);
345                console.warn(`[Telegram] Rate limit (429) asks to retry after ${waitMs / 1000}s — exceeds ${MAX_RETRY_WAIT_MS / 1000}s cap, skipping message`);
346                return false;
347            }
348            noteRateLimit(waitMs);
349            console.log(`[T] Rate limit (429). Retrying after ${waitMs / 1000}s`);
350            await sleep(waitMs);
351            return sendMessageChunkWithRetry(text, options, retryDelayMs, maxRetries - 1);
352        }
353        console.error('[T] sendMessage failed:', err.message ?? error);
354        return false;
355    }
356}
357
358async function runTelegramOpWithRetry(
359    label: string,
360    op: () => Promise<unknown>,
361    retryDelayMs = DEFAULT_RETRY_DELAY_MS,
362    maxRetries = DEFAULT_MAX_RETRIES,
363): Promise<boolean> {
364    try {
365        const racedOp = await raceWithHardTimeout(op());
366        if (racedOp === HARD_TIMEOUT) {
367            console.warn(`[T] ${label} did not settle within ${SEND_HARD_TIMEOUT_MS / 1000}s — skipping`);
368            return false;
369        }
370        return true;
371    } catch (error: unknown) {
372        if (telegramStatusCode(error) === 429 && maxRetries > 0) {
373            const waitMs = telegram429RetryAfterMs(error, retryDelayMs);
374            if (waitMs > MAX_RETRY_WAIT_MS) {
375                noteRateLimit(waitMs);
376                console.warn(`[Telegram] Rate limit (429) asks to retry after ${waitMs / 1000}s — exceeds ${MAX_RETRY_WAIT_MS / 1000}s cap, skipping`);
377                return false;
378            }
379            noteRateLimit(waitMs);
380            console.log(`[T] Rate limit (429) during ${label}. Retrying after ${waitMs / 1000}s`);
381            await sleep(waitMs);
382            return runTelegramOpWithRetry(label, op, retryDelayMs, maxRetries - 1);
383        }
384        console.error(`[T] ${label} failed:`, (error as { message?: string })?.message ?? error);
385        return false;
386    }
387}
388
389async function sendChunkedMessage(
390    fullText: string,
391    options?: TelegramBot.SendMessageOptions,
392): Promise<boolean> {
393    const chunks = splitMessage(fullText);
394    for (let i = 0; i < chunks.length; i++) {
395        const chunk = chunks[i];
396        const partInfo = chunks.length > 1 ? ` (${i + 1}/${chunks.length})` : '';
397        const opts = i === 0 ? options : undefined;
398        if (!(await sendMessageChunkWithRetry(chunk + partInfo, opts))) {
399            return false;
400        }
401        if (i < chunks.length - 1) {
402            await sleep(CHUNK_GAP_MS);
403        }
404    }
405    return true;
406}
407
408export const sentMessage = async (message: string): Promise<void> => {
409    if (!shouldDeliver(message)) return;
410    const full = `${BRAND}: ${message}\nRun: ${apifyRunLinkForMessage()}`;
411    if (await sendChunkedMessage(full)) {
412        console.log('[T] sentMessage delivered');
413    }
414};
415
416export const sent2Telegram = async (message: string, buffer: string | Stream | Buffer): Promise<void> => {
417    if (!shouldDeliver(message)) return;
418    if (await runTelegramOpWithRetry('sendPhoto', () => bot.sendPhoto(chatId, buffer, {}))) {
419        console.log('[T] Photo sent to Telegram successfully');
420    }
421    const full = `${BRAND}: ${message}\nRun: ${apifyRunLinkForMessage()}`;
422    await sendChunkedMessage(full);
423};
424
425export const sendToTelegram = async (
426    message: string | TelegramBot,
427    options?: TelegramBot.SendMessageOptions | undefined,
428    retryDelay = DEFAULT_RETRY_DELAY_MS,
429    maxRetries = DEFAULT_MAX_RETRIES,
430): Promise<void> => {
431    const messageStr = message.toString();
432    if (!shouldDeliver(messageStr)) return;
433    const chunks = splitMessage(messageStr);
434    for (let i = 0; i < chunks.length; i++) {
435        const chunk = chunks[i];
436        const partInfo = chunks.length > 1 ? ` (${i + 1}/${chunks.length})` : '';
437        const opts = i === 0 ? (options as TelegramBot.SendMessageOptions | undefined) : undefined;
438        await sendMessageChunkWithRetry(chunk + partInfo, opts, retryDelay, maxRetries);
439        if (i < chunks.length - 1) {
440            await sleep(CHUNK_GAP_MS);
441        }
442    }
443};
444
445export const takeScreenshot = async (page: any, maxRetries = 3) => {
446    let attempts = 0;
447
448    while (attempts < maxRetries) {
449        try {
450            const screenshotBuffer = await page.screenshot();
451            console.log('Screenshot taken successfully:');
452            return screenshotBuffer;
453        } catch (error) {
454            console.error('Error taking screenshot:', error);
455            attempts++;
456            if (attempts >= maxRetries) {
457                console.error('Max retry attempts reached. Giving up.');
458                throw error;
459            }
460            console.log(`Retrying screenshot... Attempt ${attempts + 1}`);
461        }
462    }
463};

test/fixtures/auth_gb.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on United Kingdom company LIBRA INVESTMENT PROPERTY GROUP LIMITED (company number 05957738), Penycastell Farm
Bryn, Port Talbot, West Glamorgan, SA13 2PY' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, LIBRA INVESTMENT PROPERTY GROUP LIMITED, United Kingdom' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/gb/05957738" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="IEtKHucDDo7L20zYIumwaL3AWJsADthfjAHX7bIIxss=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li class='user-dropdown'>
<a class='user-badge' href='#' rel='nofollow' title='Your account'>
<span class='initials-circle'>M</span>
</a>
<div class='user-dropdown-menu'>
<a href="/users/account" rel="nofollow">My Account</a>
<a data-method="delete" href="/users/sign_out" rel="nofollow">Logout</a>
</div>
</li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
LIBRA INVESTMENT PROPERTY GROUP LIMITED
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">05957738</dd>



<dt>Status</dt> <dd class="status">Active</dd>
<dt>Incorporation Date</dt> <dd class="incorporation_date"><span itemprop='foundingDate' datetime=2006-10-05> 5 October 2006</span> (about 20 years ago)</dd>

<dt>Company Type</dt> <dd class="company_type">Private Limited Company</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies">United Kingdom</a></dd>







<dt>Ultimate Beneficial Owners</dt> <dd class="ultimate_beneficial_owners"><ul class="attribute_list"><li class="attribute_item">Mr David Ian Bromley </li><li class="attribute_item">Mr David Ian Bromley-Cornfield </li><li class="attribute_item">Mrs Elizabeth Davies </li></ul></dd>
<dt>Registered Address</dt> <dd class="registered_address adr"><ul class="address_lines"><li class="address_line">Penycastell Farm<br />Bryn</li><li class="address_line">Port Talbot</li><li class="address_line">SA13 2PY</li><li class="address_line">West Glamorgan</li><li class="address_line">United Kingdom</li></ul></dd>
<dt>Industry Codes</dt> <dd class="industry_codes"><ul class="attribute_list"><li class="attribute_item">70.10: Activities of head offices (UK SIC Classification 2007)</li><li class="attribute_item">70.10: Activities of head offices (European Community NACE Rev 2)</li><li class="attribute_item">7010: Activities of head offices (UN ISIC Rev 4)</li></ul></dd>


<dt>Latest Accounts Date</dt> <dd class="latest_accounts_date">2025-03-31</dd>
<dt>Annual Return Last Made Up Date</dt> <dd class="annual_return_last_made_up_date">2015-10-05</dd>
<dt>Previous Names</dt> <dd class="previous_names"><ul class="name_lines"><li class="name_line">£IBRA FINANCIAL SERVICES LIMITED</li></ul></dd>




<dt><a href="/companies/gb/05957738/officers" title="Directors for LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom)">Directors / Officers</a></dt> <dd class="officers"><ul class="attribute_list"><li class="attribute_item"><a class="officer" href="/officers/201499282" title="more info on DAVID IAN BROMLEY-CORNFIELD">DAVID IAN BROMLEY-CORNFIELD</a>, director, <span class="start_date"> 1 Oct 2010</span>- </li><li class="attribute_item"><a class="officer" href="/officers/201499336" title="more info on ELIZABETH DAVIES">ELIZABETH DAVIES</a>, director, <span class="start_date"> 5 Oct 2006</span>- </li></ul></dd>

<dt><a href="/companies/gb/05957738/officers" title="Inactive Directors for LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom)">Inactive Directors / Officers</a></dt> <dd class="inactive_officers"><ul class="attribute_list"><li class="attribute_item"><a class="officer inactive" href="/officers/201499298" title="more info on DAVID IAN BROMLEY">DAVID IAN BROMLEY</a>, director, <span class="start_date"> 5 Oct 2006</span>-<span class="end_date">26 Jan 2007</span></li><li class="attribute_item"><a class="officer inactive" href="/officers/201499267" title="more info on PHOENIX AUDIT LIMITED">PHOENIX AUDIT LIMITED</a>, secretary, <span class="start_date"> 5 Oct 2006</span>-<span class="end_date"> 5 Oct 2009</span></li><li class="attribute_item"><a class="officer inactive" href="/officers/201499319" title="more info on SALLY-ANN MICHELLE BROMLEY">SALLY-ANN MICHELLE BROMLEY</a>, director, <span class="start_date">21 Dec 2012</span>-<span class="end_date">28 Mar 2019</span></li></ul></dd>

</dl>
</div>
</div>

<div id='company_data'>
<div id='update_links'></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last Update From Source</dt> <dd class="last_update_from_source">29 October 2026</dd>
<dt>Last Change Recorded</dt> <dd class="last_change_recorded">28 September 2026</dd>
<dt>Next Update From Source</dt> <dd class="next_update_from_source">Daily</dd>
<dt>Source</dt> <dd class="source"><a href="https://beta.companieshouse.gov.uk/company/05957738">UK Companies House</a></dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_object'>
<h3>
Statements of control (by this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (by this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2016-10-05
</td>
<td>
Mr David Ian Bromley  and Mr David Ian Bromley-Cornfield  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- )
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/2255744855">details</a>
</td>
</tr>
<tr>
<td>
2016-10-05
</td>
<td>
Mrs Elizabeth Davies  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- )
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/2255744858">details</a>
</td>
</tr>
<tr>
<td>
2016-10-05
</td>
<td>
Mrs Sally-Ann Michelle Bromley  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- )
</td>
<td>
Share Ownership
</td>
<td><span class="status label">historic</span> </td>
<td>
<a href="/statements/2255744857">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_subject'>
<h3>
Statements of control (relating to this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (relating to this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2017-01-26
</td>
<td>
<a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/07137174" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES RCT LIMITED (United Kingdom, 07137174)">LIBRA INVESTMENT PROPERTY SERVICES RCT LIMITED</a> (United Kingdom, <span class="start_date">26 Jan 2010</span>- )
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1943654210">details</a>
</td>
</tr>
<tr>
<td>
2016-08-02
</td>
<td>
<a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/06331958" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES LIMITED (United Kingdom, 06331958)">LIBRA INVESTMENT PROPERTY SERVICES LIMITED</a> (United Kingdom, <span class="start_date"> 2 Aug 2007</span>- )
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1950321413">details</a>
</td>
</tr>
<tr>
<td>
2016-04-06
</td>
<td>
Libra Investment Property Group Ltd  and <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom, <span class="start_date"> 5 Oct 2006</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/06925425" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES WMSA LIMITED (United Kingdom, 06925425)">LIBRA INVESTMENT PROPERTY SERVICES WMSA LIMITED</a> (United Kingdom, <span class="start_date"> 5 Jun 2009</span>-<span class="end_date"> 7 Jan 2020</span>)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1946685971">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-filing_delegate'>
<h3>
Filings
<span class='heading-help'>
<a class='data-type-description' data-content='Filings are official documents filed with a publisher who usually has regulatory powers' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Filings'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Filing Date</th>
<th>Title</th>
<th>Description</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2026-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzUyMjU1MTQ0OGFkaXF6a2N4/document" target="_blank" title="View Give notice of change of details for person with significant control for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Give notice of change of details for person with significant control</a></span>
</td>
<td>
Change of details for Mr David Ian Bromley as a person with significant control on 2026-05-18
</td>
<td></td>
<td>
<a href="/statements/2209885114">details</a>
</td>
</tr>
<tr>
<td>
2026-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzUyMjU1MTg2NGFkaXF6a2N4/document" target="_blank" title="View Change of director&#39;s details for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of director&#39;s details</a></span>
</td>
<td>
Director&#39;s details changed for Mr David Ian Bromley on 2026-05-18
</td>
<td></td>
<td>
<a href="/statements/2209885113">details</a>
</td>
</tr>
<tr>
<td>
2026-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzUyMjU4NzEzM2FkaXF6a2N4/document" target="_blank" title="View Confirmation Statement for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Confirmation Statement</a></span>
</td>
<td>
Confirmation statement made on 2026-05-06 with updates
</td>
<td></td>
<td>
<a href="/statements/2209885111">details</a>
</td>
</tr>
<tr>
<td>
2026-03-24
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzUxMjIyNjgzM2FkaXF6a2N4/document" target="_blank" title="View Annual Accounts for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Annual Accounts</a></span>
</td>
<td>
Total exemption full accounts made up to 2025-03-31
</td>
<td></td>
<td>
<a href="/statements/2193147919">details</a>
</td>
</tr>
<tr>
<td>
2025-12-27
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ5NjUyNjczOWFkaXF6a2N4/document" target="_blank" title="View Change of accounting reference date for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of accounting reference date</a></span>
</td>
<td>
Previous accounting period shortened from 2025-03-27 to 2025-03-26
</td>
<td></td>
<td>
<a href="/statements/2164467045">details</a>
</td>
</tr>
<tr>
<td>
2025-05-21
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ2NzM1NTM3MmFkaXF6a2N4/document" target="_blank" title="View Confirmation Statement for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Confirmation Statement</a></span>
</td>
<td>
Confirmation statement made on 2025-05-06 with no updates
</td>
<td></td>
<td>
<a href="/statements/2086292256">details</a>
</td>
</tr>
<tr>
<td>
2025-02-07
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ1NDA4ODcwM2FkaXF6a2N4/document" target="_blank" title="View Annual Accounts for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Annual Accounts</a></span>
</td>
<td>
Total exemption full accounts made up to 2024-03-31
</td>
<td></td>
<td>
<a href="/statements/2058753885">details</a>
</td>
</tr>
<tr>
<td>
2024-12-20
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ0ODU0OTUyOWFkaXF6a2N4/document" target="_blank" title="View Change of accounting reference date for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of accounting reference date</a></span>
</td>
<td>
Previous accounting period shortened from 2024-03-28 to 2024-03-27
</td>
<td></td>
<td>
<a href="/statements/2023010971">details</a>
</td>
</tr>
<tr>
<td>
2024-12-20
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ0ODU1MTg4NWFkaXF6a2N4/document" target="_blank" title="View Change of director&#39;s details for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of director&#39;s details</a></span>
</td>
<td>
Director&#39;s details changed for Mr David Ian Bromley on 2024-12-20
</td>
<td></td>
<td>
<a href="/statements/2023010968">details</a>
</td>
</tr>
<tr>
<td>
2024-12-20
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQ0ODU1MjI2MWFkaXF6a2N4/document" target="_blank" title="View Give notice of change of details for person with significant control for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Give notice of change of details for person with significant control</a></span>
</td>
<td>
Change of details for Mr David Ian Bromley as a person with significant control on 2024-12-20
</td>
<td></td>
<td>
<a href="/statements/2023010965">details</a>
</td>
</tr>
<tr>
<td>
2024-05-20
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQyMjM4OTAyNmFkaXF6a2N4/document" target="_blank" title="View Confirmation Statement for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Confirmation Statement</a></span>
</td>
<td>
Confirmation statement made on 2024-05-06 with no updates
</td>
<td></td>
<td>
<a href="/statements/1808331089">details</a>
</td>
</tr>
<tr>
<td>
2024-02-02
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQwOTc3NjA2OGFkaXF6a2N4/document" target="_blank" title="View Annual Accounts for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Annual Accounts</a></span>
</td>
<td>
Total exemption full accounts made up to 2023-03-31
</td>
<td></td>
<td>
<a href="/statements/1735561871">details</a>
</td>
</tr>
<tr>
<td>
2023-12-22
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzQwNTQ0OTc1MWFkaXF6a2N4/document" target="_blank" title="View Change of accounting reference date for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of accounting reference date</a></span>
</td>
<td>
Previous accounting period shortened from 2023-03-29 to 2023-03-28
</td>
<td></td>
<td>
<a href="/statements/1700309495">details</a>
</td>
</tr>
<tr>
<td>
2023-05-25
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzM4MDg1MzE4OWFkaXF6a2N4/document" target="_blank" title="View Confirmation Statement for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Confirmation Statement</a></span>
</td>
<td>
Confirmation statement made on 2023-05-06 with no updates
</td>
<td></td>
<td>
<a href="/statements/1526903274">details</a>
</td>
</tr>
<tr>
<td>
2023-03-08
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzM3MTg3MzQ5MmFkaXF6a2N4/document" target="_blank" title="View Annual Accounts for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Annual Accounts</a></span>
</td>
<td>
Total exemption full accounts made up to 2022-03-31
</td>
<td></td>
<td>
<a href="/statements/1465352811">details</a>
</td>
</tr>
<tr>
<td>
2022-12-29
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzM2NDA5NDE0M2FkaXF6a2N4/document" target="_blank" title="View Change of accounting reference date for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of accounting reference date</a></span>
</td>
<td>
Previous accounting period shortened from 2022-03-30 to 2022-03-29
</td>
<td></td>
<td>
<a href="/statements/1402249448">details</a>
</td>
</tr>
<tr>
<td>
2022-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzMzOTgyNzQ0N2FkaXF6a2N4/document" target="_blank" title="View Confirmation Statement for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Confirmation Statement</a></span>
</td>
<td>
Confirmation statement made on 2022-05-06 with no updates
</td>
<td></td>
<td>
<a href="/statements/1265288132">details</a>
</td>
</tr>
<tr>
<td>
2022-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzMzOTgyNzIyMmFkaXF6a2N4/document" target="_blank" title="View Change of director&#39;s details for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Change of director&#39;s details</a></span>
</td>
<td>
Director&#39;s details changed for Mr David Ian Bromley on 2022-05-19
</td>
<td></td>
<td>
<a href="/statements/1265288134">details</a>
</td>
</tr>
<tr>
<td>
2022-05-19
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzMzOTgyNzAwMWFkaXF6a2N4/document" target="_blank" title="View Give notice of change of details for person with significant control for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Give notice of change of details for person with significant control</a></span>
</td>
<td>
Change of details for Mr David Ian Bromley as a person with significant control on 2022-05-19
</td>
<td></td>
<td>
<a href="/statements/1265288136">details</a>
</td>
</tr>
<tr>
<td>
2022-03-18
</td>
<td>
<span class="filing_link"><a class="external filing_url" href="https://beta.companieshouse.gov.uk/company/05957738/filing-history/MzMzMzMyMTc1OWFkaXF6a2N4/document" target="_blank" title="View Annual Accounts for LIBRA INVESTMENT PROPERTY GROUP LIMITED">Annual Accounts</a></span>
</td>
<td>
Total exemption full accounts made up to 2021-03-31
</td>
<td></td>
<td>
<a href="/statements/1237406178">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/gb/05957738/statements/filing_delegate">See all (71 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-industry_code'>
<h3>
Industry codes
<span class='heading-help'>
<a class='data-type-description' data-content='A classification denoting the industry or sector a company is in, according to a specific code list (e.g. NAICS, NACE)' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Industry codes'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Code</th>
<th>Description</th>
<th>Code scheme</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
70.10
</td>
<td>
Activities of head offices
</td>
<td>
UK SIC Classification 2007
</td>
<td></td>
<td>
<a href="/statements/60311892">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>

<script>
  window.dataLayer = window.dataLayer || [];
  dataLayer.push({
    event: 'login',
    user_properties: {
      user_id: "0",
      business_id: "",
      business_domain_name: "example.com",
      logged_in: true
    }
  });
</script>

</body>
</html>

test/fixtures/auth_us_ca.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on California (US) company APPLE INC. (company number 0806592), ONE APPLE PARK WAY, CUPERTINO, CA, 95014' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, APPLE INC., California (US)' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/us_ca/0806592" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="uE4MJuXaRZiS56sTq0xoUjODPJ7oreCin/r27jMq/z4=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li class='user-dropdown'>
<a class='user-badge' href='#' rel='nofollow' title='Your account'>
<span class='initials-circle'>M</span>
</a>
<div class='user-dropdown-menu'>
<a href="/users/account" rel="nofollow">My Account</a>
<a data-method="delete" href="/users/sign_out" rel="nofollow">Logout</a>
</div>
</li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
APPLE INC.
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">0806592</dd>

<dt>Previous Company Numbers</dt> <dd class="previous_company_numbers"><ul class="attribute_list"><li class="attribute_item">C0806592</li></ul></dd>
<dt>Other Identifiers</dt> <dd class="other_identifiers"><ul class="attribute_list"><li class="attribute_item"><a class="identifier" href="/identifiers/cage/58839" title="US Federal &#39;Commercial And Government Entity&#39; Register: 58839">US Federal CAGE number: 58839</a></li><li class="attribute_item"><a class="identifier" href="/identifiers/cik/320193" title="US Securities And Exchange Commission CIK number: 320193">SEC CIK number: 320193</a></li><li class="attribute_item"><a class="identifier" href="/identifiers/fein/942404110" title="US Federal Employee Identification Number: 942404110">US EIN number: 942404110</a></li></ul></dd>
<dt>Status</dt> <dd class="status">Active</dd>
<dt>Incorporation Date</dt> <dd class="incorporation_date"><span itemprop='foundingDate' datetime=1977-01-03> 3 January 1977</span> (almost 50 years ago)</dd>

<dt>Company Type</dt> <dd class="company_type">Stock Corporation - CA - General</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies">California (US)</a></dd>








<dt>Registered Address</dt> <dd class="registered_address adr"><ul class="address_lines"><li class="address_line">ONE APPLE PARK WAY</li><li class="address_line">CUPERTINO</li><li class="address_line">95014</li><li class="address_line">CA</li><li class="address_line">United States</li></ul></dd>








<dt>Agent Name</dt> <dd class="agent_name">C T CORPORATION SYSTEM</dd>
<dt>Agent Address</dt> <dd class="agent_address">330 N BRAND BLVD STE # 700, GLENDALE, CA, 91203, UNITED STATES</dd>
<dt><a href="/companies/us_ca/0806592/officers" title="Directors for APPLE INC. (California (US))">Directors / Officers</a></dt> <dd class="officers"><ul class="attribute_list"><li class="attribute_item"><a class="officer" href="/officers/836982479" title="more info on Alex Gorsky">Alex Gorsky</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1001460441" title="more info on Andrea Jung">Andrea Jung</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1065713111" title="more info on Andrew Stein">Andrew Stein</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1065713110" title="more info on Anna Pletcher">Anna Pletcher</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1045080806" title="more info on Arthur Levinson">Arthur Levinson</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1065713109" title="more info on BJ Watrous">BJ Watrous</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1045080810" title="more info on Ben Borders">Ben Borders</a></li><li class="attribute_item"><a class="officer" href="/officers/171544046" title="more info on C T CORPORATION SYSTEM">C T CORPORATION SYSTEM</a>, agent</li><li class="attribute_item"><a class="officer" href="/officers/836982455" title="more info on Deirdre O&#39;Brien">Deirdre O&#39;Brien</a>, other</li><li class="attribute_item"><a class="officer" href="/officers/1065713112" title="more info on Diek Van North">Diek Van North</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1065713105" title="more info on Jennifer Newstead">Jennifer Newstead</a></li><li class="attribute_item"><a class="officer" href="/officers/1065713108" title="more info on Jennifer Newstead">Jennifer Newstead</a>, secretary</li><li class="attribute_item"><a class="officer" href="/officers/1065713106" title="more info on John Ternus">John Ternus</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1065713107" title="more info on John Ternus">John Ternus</a>, chief executive officer</li><li class="attribute_item"><a class="officer" href="/officers/1001460381" title="more info on Kevan Parekh">Kevan Parekh</a>, chief financial officer</li><li class="attribute_item"><a class="officer" href="/officers/836982434" title="more info on Kyle Andeer">Kyle Andeer</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1001460396" title="more info on Matt Miller">Matt Miller</a>, assistant treasurer</li><li class="attribute_item"><a class="officer" href="/officers/1001460393" title="more info on Michael Shapiro">Michael Shapiro</a></li><li class="attribute_item"><a class="officer" href="/officers/836982473" title="more info on Monica Lozano">Monica Lozano</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1001460423" title="more info on Ronald D. Sugar">Ronald D. Sugar</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/1045080809" title="more info on Sabih Khan">Sabih Khan</a></li><li class="attribute_item"><a class="officer" href="/officers/1001460432" title="more info on Sam Whittington">Sam Whittington</a>, assistant secretary</li><li class="attribute_item"><a class="officer" href="/officers/1045080811" title="more info on Susan Wagner">Susan Wagner</a>, director</li><li class="attribute_item"><a class="officer" href="/officers/502280249" title="more info on Timothy Cook">Timothy Cook</a>, chief executive officer</li><li class="attribute_item"><a class="officer" href="/officers/1001460429" title="more info on Wanda Austin">Wanda Austin</a>, director</li></ul></dd>

<dt><a href="/companies/us_ca/0806592/officers" title="Inactive Directors for APPLE INC. (California (US))">Inactive Directors / Officers</a></dt> <dd class="inactive_officers"><ul class="attribute_list"><li class="attribute_item"><a class="officer inactive" href="/officers/836982431" title="more info on Alanna Rutherford">Alanna Rutherford</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1022560306" title="more info on Alexis Amezcua">Alexis Amezcua</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460417" title="more info on Arthur D. Levinson">Arthur D. Levinson</a>, director</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460408" title="more info on Bruce H. Watrous">Bruce H. Watrous</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1045080808" title="more info on Bruce Watrous">Bruce Watrous</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460414" title="more info on Chris Kondo">Chris Kondo</a></li><li class="attribute_item"><a class="officer inactive" href="/officers/836982461" title="more info on Colette Mayer">Colette Mayer</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/881492249" title="more info on Deirdre O&amp;#39;Brien">Deirdre O&amp;#39;Brien</a>, other</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982452" title="more info on Heather Grenier">Heather Grenier</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982467" title="more info on James Bell">James Bell</a>, director</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460411" title="more info on Jamie Wong">Jamie Wong</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460435" title="more info on Jeff Myers">Jeff Myers</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460390" title="more info on Jeff Williams">Jeff Williams</a></li><li class="attribute_item"><a class="officer inactive" href="/officers/836982458" title="more info on Jeffrey Myers">Jeffrey Myers</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460399" title="more info on Jen Brown">Jen Brown</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982443" title="more info on Kate Adams">Kate Adams</a>, other</li><li class="attribute_item"><a class="officer inactive" href="/officers/1045080807" title="more info on Kate Adams">Kate Adams</a>, secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460402" title="more info on Kate Kaso-Howard">Kate Kaso-Howard</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460378" title="more info on Katherine Adams">Katherine Adams</a>, secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460384" title="more info on Katherine Adams">Katherine Adams</a></li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460387" title="more info on Kevan Parekh">Kevan Parekh</a></li><li class="attribute_item"><a class="officer inactive" href="/officers/836982449" title="more info on Matthew Currie">Matthew Currie</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982440" title="more info on Peter R. Denwood">Peter R. Denwood</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982446" title="more info on Samuel John Whittington">Samuel John Whittington</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460426" title="more info on Susan L. Wagner">Susan L. Wagner</a>, director</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460405" title="more info on Thomas R. LaPerle">Thomas R. LaPerle</a>, assistant secretary</li><li class="attribute_item"><a class="officer inactive" href="/officers/836982464" title="more info on Timothy Cook">Timothy Cook</a>, director</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460375" title="more info on Timothy D. Cook">Timothy D. Cook</a>, chief executive officer</li><li class="attribute_item"><a class="officer inactive" href="/officers/1001460438" title="more info on Timothy D. Cook">Timothy D. Cook</a>, director</li></ul></dd>

</dl>
</div>
</div>

<div id='filings'>
<div class='rss_feed'><a href="/companies/us_ca/0806592/filings.rss" title="Subscribe to filings for APPLE INC."><img alt="RSS feed icon" src="https://cdn.opencorporates.com/assets/feed_icon-67c607b1dae7bfb208b04acfe9a07e50.gif" /></a></div>
<h3><a href="https://opencorporates.com/companies/us_ca/0806592/filings" title="See all filings for APPLE INC.">Recent filings for APPLE INC.</a></h3>
<div class="filing" id="filing_1070407905"><div class='dateline'>28 Jan 2022</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/1070407905" title="more info on PUBLICLY TRADED DISCLOSURE">PUBLICLY TRADED DISCLOSURE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_1076962611"><div class='dateline'>27 Jan 2022</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/1076962611" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_986944551"><div class='dateline'> 9 Jul 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/986944551" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_979103133"><div class='dateline'> 8 Jul 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/979103133" title="more info on FILING OFFICE STATEMENT">FILING OFFICE STATEMENT</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_699793136"><div class='dateline'> 9 Mar 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/699793136" title="more info on PUBLICLY TRADED DISCLOSURE">PUBLICLY TRADED DISCLOSURE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_986944548"><div class='dateline'> 8 Dec 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/986944548" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_676506521"><div class='dateline'> 3 Aug 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/676506521" title="more info on RESTATED REGISTRATION">RESTATED REGISTRATION</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_676506518"><div class='dateline'> 3 Aug 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/676506518" title="more info on AMENDMENT">AMENDMENT</a>
</div>
<p class='description'>

</p>
</div>
</div>
<p class='more_info'><a href="https://opencorporates.com/companies/us_ca/0806592/filings">see all filings</a></p>
</div>
<div id='company_data'>
<div id='update_links'></div>
<div id="assertions"><div class="assertion_group" id="company_addresses"><h3>Company Addresses</h3><div class="summary"><a href="/data?assertion_type=CompanyAddress&amp;company_id%5B%5D=23317130">506</a> Company Addresses, showing 10 most recently added</div><div class="assertion company_address" id="assertion_44563177"><div class='subhead'>
<a href="/data/44563177">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_44564184"><div class='subhead'>
<a href="/data/44564184">Company Address</a>
</div>
<p class='description'>
1 INFINITE LOOP, CUPERTINO CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_45344563"><div class='subhead'>
<a href="/data/45344563">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47902646"><div class='subhead'>
<a href="/data/47902646">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47908349"><div class='subhead'>
<a href="/data/47908349">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47973669"><div class='subhead'>
<a href="/data/47973669">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_48623831"><div class='subhead'>
<a href="/data/48623831">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_49213402"><div class='subhead'>
<a href="/data/49213402">Company Address</a>
</div>
<p class='description'>
1 INFINITE LOOP, CUPERTINO CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_49687945"><div class='subhead'>
<a href="/data/49687945">Mailing Address</a>
</div>
<p class='description'>
ONE APPLE PARK WAY, CUPERTINO, CA, 95014, United States
</p>
</div><div class="assertion company_address" id="assertion_160580885"><div class='subhead'>
<a href="/data/160580885">Head Office Address</a>
</div>
<p class='description'>
ONE APPLE PARK WAY, CUPERTINO, CA, 95014, United States
</p>
</div></div><div class="assertion_group" id="websites"><h3>Websites</h3><div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/4912925">Website</a>
</div>
<p class='description'>
<a class="external" href="http://www.apple.com/federal/" rel="nofollow">http://www.apple.com/federal/</a>
</p>
</div>
<div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/5400399">Website</a>
</div>
<p class='description'>
<a class="external" href="http://www.apple.com/federal/" rel="nofollow">http://www.apple.com/federal/</a>
</p>
</div>
<div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/10086458">Website</a>
</div>
<p class='description'>
<a class="external" href="https://www.apple.com/" rel="nofollow">https://www.apple.com/</a>
</p>
</div>
</div><div class="assertion_group" id="government_approved_suppliers"><h3>Approved Government Suppliers</h3><div class="assertion government_approved_supplier" id="assertion_2685133"><div class='subhead'>
<a href="/data/2685133">Approved US Government Supplier</a>
</div>
<p class='description'>

</p>
</div></div><div class="assertion_group" id="official_register_entries"><h3>Official Register Entries</h3><div class="assertion official_register_entry" id="assertion_3805853"><div class='subhead'>
<a href="/data/3805853">SEC Edgar entry</a>
</div>
<p class='description'>
register id: 320193
</p>
</div></div><div class="assertion_group" id="telephone_numbers"><h3>Telephone Numbers</h3><div class="assertion telephone_number" id="assertion_4912926"><div class='subhead'>
<a href="/data/4912926">Telephone Number</a>
</div>
<p class='description'>
Number: +1 7032643249
</p>
</div></div><div class="assertion_group" id="tax_numbers"><h3>Tax Numbers</h3><div class="assertion tax_number" id="assertion_7825775"><div class='subhead'>
<a href="/data/7825775">Tax Number</a>
</div>
<p class='description'>
US EIN number: 942404110
</p>
</div></div></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last Update From Source</dt> <dd class="last_update_from_source">26 October 2026</dd>
<dt>Last Change Recorded</dt> <dd class="last_change_recorded">24 October 2026</dd>
<dt>Next Update From Source</dt> <dd class="next_update_from_source">Monthly</dd>
<dt>Source</dt> <dd class="source"><a href="https://bizfileonline.sos.ca.gov/search/business">California Secretary of State</a></dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

<div class='sidebar'>
<div class='sidebar-item' id='similarly_named'>
<h3><a href="/companies?q=APPLE+INC." title="Companies named APPLE INC.">Similarly named companies</a></h3>
<p>
<a href="/companies?q=APPLE+INC." title="Companies named APPLE INC.">Found 13447.</a>
Showing first 10
</p>
<ul class='companies'>
<li class='active/compliance'>
<a class="jurisdiction_filter us" href="/companies/us_ga" title="Free And Open Data On Georgia (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active/compliance" href="/companies/us_ga/21312615" title="More Free And Open Company Data On GRAVITY APPLE, Incorporated (Georgia (US), 21312615)">GRAVITY APPLE, Incorporated</a> (Georgia (US), <span class="start_date">22 Dec 2021</span>- )
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0100512323" title="More Free And Open Company Data On ASA APPLE INCORPORATED (New Jersey (US), 0100512323)">ASA APPLE INCORPORATED</a> (New Jersey (US), <span class="start_date">19 Mar 1992</span>- )
</li>
<li class='active'>
<a class="jurisdiction_filter us" href="/companies/us_ny" title="Free And Open Data On New York (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ny/7879815" title="More Free And Open Company Data On PINK APPLE INCORPORATED (New York (US), 7879815)">PINK APPLE INCORPORATED</a> (New York (US), <span class="start_date"> 6 Apr 2026</span>- )
</li>
<li class='delinquent'>
<a class="jurisdiction_filter us" href="/companies/us_co" title="Free And Open Data On Colorado (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company delinquent" href="/companies/us_co/20251545548" title="More Free And Open Company Data On black apple incorporated (Colorado (US), 20251545548)">black apple incorporated</a> (Colorado (US), <span class="start_date">14 May 2025</span>- )
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0450480559" title="More Free And Open Company Data On MAMMEE APPLE INCORPORATED (New Jersey (US), 0450480559)">MAMMEE APPLE INCORPORATED</a> (New Jersey (US), <span class="start_date"> 8 Apr 2020</span>- )
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0400299318" title="More Free And Open Company Data On WILD APPLE INCORPORATED (New Jersey (US), 0400299318)">WILD APPLE INCORPORATED</a> (New Jersey (US), <span class="start_date">29 Jul 2009</span>- )
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_de" title="Free And Open Data On Delaware (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_de/2842501" title="More Free And Open Company Data On CHERRY APPLE INCORPORATED (Delaware (US), 2842501)">CHERRY APPLE INCORPORATED</a> (Delaware (US), <span class="start_date">27 Dec 2023</span>- )
</li>
<li class='multiple'>
<a class="jurisdiction_filter us" href="/companies/us_nc" title="Free And Open Data On North Carolina (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company multiple" href="/companies/us_nc/0347181" title="More Free And Open Company Data On MARK A. APPLE, INCORPORATED (North Carolina (US), 0347181)">MARK A. APPLE, INCORPORATED</a> (North Carolina (US), <span class="start_date">21 Jun 1994</span>- )
</li>
<li class='active'>
<a class="jurisdiction_filter us" href="/companies/us_ny" title="Free And Open Data On New York (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">nonprofit</span>  <a class="company active" href="/companies/us_ny/4733087" title="More Free And Open Company Data On FEEDING THE BIG APPLE INCORPORATED (New York (US), 4733087)">FEEDING THE BIG APPLE INCORPORATED</a> (New York (US), <span class="start_date">27 Mar 2015</span>- )
</li>
<li class='inactive inactive'>
<a class="jurisdiction_filter us" href="/companies/us_ky" title="Free And Open Data On Kentucky (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive inactive" href="/companies/us_ky/0172251" title="More Free And Open Company Data On APPLE INCORPORATED (Kentucky (US), 0172251)">APPLE INCORPORATED</a> (Kentucky (US), <span class="start_date">19 Nov 1982</span>- )
</li>
</ul>
</div>

</div>
</div>
</div>
<div class='row'>
<div class='span12'>
<div id='data-table-branch_relationship_subject'>
<h3>
Branches
<span class='heading-help'>
<a class='data-type-description' data-content='A branch company is an out-of-jurisdiction registration of a company (in the US it is often referred to as a &#39;Foreign Corporation&#39;)' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Branches'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
</thead>
<tbody>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ar" title="Free And Open Data On Arkansas (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch good_standing" href="/companies/us_ar/811516357" title="More Free And Open Company Data On APPLE COMPUTER INC. (Arkansas (US), 811516357)">APPLE COMPUTER INC.</a> (Arkansas (US), <span class="start_date">27 Sep 2024</span>- )
</td>
<td></td>
<td>
<a href="/statements/1915384745">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ky" title="Free And Open Data On Kentucky (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch active" href="/companies/us_ky/0654776" title="More Free And Open Company Data On APPLE INC. (Kentucky (US), 0654776)">APPLE INC.</a> (Kentucky (US), <span class="start_date"> 8 Feb 2007</span>- )
</td>
<td></td>
<td>
<a href="/statements/72990646">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_me" title="Free And Open Data On Maine (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch good_standing" href="/companies/us_me/20140693F" title="More Free And Open Company Data On APPLE INC. (Maine (US), 20140693F)">APPLE INC.</a> (Maine (US), <span class="start_date">27 Mar 2014</span>- )
</td>
<td></td>
<td>
<a href="/statements/578346333">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_wa" title="Free And Open Data On Washington (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch active" href="/companies/us_wa/600518265" title="More Free And Open Company Data On APPLE INC. (Washington (US), 600518265)">APPLE INC.</a> (Washington (US), <span class="start_date">31 Mar 2009</span>- )
</td>
<td></td>
<td>
<a href="/statements/8015291">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_me" title="Free And Open Data On Maine (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">inactive</span>  <span class="status label">branch</span>  <a class="company inactive branch authority_revoked" href="/companies/us_me/20090379F" title="More Free And Open Company Data On APPLE INC. (Maine (US), 20090379F)">APPLE INC.</a> (Maine (US), <span class="start_date"> 3 Nov 2008</span>- )
</td>
<td></td>
<td>
<a href="/statements/578554290">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/branch_relationship_subject">See all (64 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_subject'>
<h3>
Statements of control (relating to this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (relating to this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2022-06-09
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US), <span class="start_date"> 3 Jan 1977</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/14162167" title="More Free And Open Company Data On APPLE TECHNOLOGY U.K. LIMITED (United Kingdom, 14162167)">APPLE TECHNOLOGY U.K. LIMITED</a> (United Kingdom, <span class="start_date"> 9 Jun 2022</span>-<span class="end_date">23 Sep 2025</span>)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1949281745">details</a>
</td>
</tr>
<tr>
<td>
2022-01-21
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US), <span class="start_date"> 3 Jan 1977</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/10733886" title="More Free And Open Company Data On AI MUSIC LIMITED (United Kingdom, 10733886)">AI MUSIC LIMITED</a> (United Kingdom, <span class="start_date">21 Apr 2017</span>-<span class="end_date"> 7 Jan 2025</span>)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1938179504">details</a>
</td>
</tr>
<tr>
<td>
2020-08-21
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US), <span class="start_date"> 3 Jan 1977</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/07768047" title="More Free And Open Company Data On SHAZAM INVESTMENTS LIMITED (United Kingdom, 07768047)">SHAZAM INVESTMENTS LIMITED</a> (United Kingdom, <span class="start_date"> 9 Sep 2011</span>-<span class="end_date">19 Aug 2025</span>)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1933901336">details</a>
</td>
</tr>
<tr>
<td>
2020-03-05
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US), <span class="start_date"> 3 Jan 1977</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/SC573253" title="More Free And Open Company Data On VOYSIS UK LIMITED (United Kingdom, SC573253)">VOYSIS UK LIMITED</a> (United Kingdom, <span class="start_date"> 9 Aug 2017</span>-<span class="end_date">14 Dec 2021</span>)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1937636993">details</a>
</td>
</tr>
<tr>
<td>
2019-11-08
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US), <span class="start_date"> 3 Jan 1977</span>- ) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a> <span class="status label">inactive</span>  <a class="company inactive dissolved" href="/companies/gb/07538488" title="More Free And Open Company Data On SPECTRAL EDGE LIMITED (United Kingdom, 07538488)">SPECTRAL EDGE LIMITED</a> (United Kingdom, <span class="start_date">22 Feb 2011</span>-<span class="end_date">13 Sep 2022</span>)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1966116344">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/control_statement_subject">See all (11 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-subsidiary_relationship_subject'>
<h3>
Subsidiaries
<span class='heading-help'>
<a class='data-type-description' data-content='A subsidiary is a company that is controlled by another company. Often the control is exerted via a majority shareholding, but can be via other mechanisms. It can also be exerted via shareholdings in other companies. When this happens, we call it an indirect subsidiary. Subsidiary information often comes from official annual reports. Companies are only obliged to report &#39;significant&#39; subsidiaries, and the definition of &#39;significant&#39; is not consistent.' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Subsidiaries'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
</thead>
<tbody>
<tr>
<td>
Apple Vietnam Limited Liability Company (Viet Nam)
</td>
<td></td>
<td>
<a href="/statements/2145105551">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter sg" href="/companies/sg" title="Free And Open Data On Singapore Companies"><img alt="Singapore flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/sg-2c4a0655b0b8c61bfb70a2c73f862180.gif" /></a>  <a class="company live_company" href="/companies/sg/198903166R" title="More Free And Open Company Data On APPLE SOUTH ASIA PTE. LTD. (Singapore, 198903166R)">APPLE SOUTH ASIA PTE. LTD.</a> (Singapore, <span class="start_date"> 1 Aug 1989</span>- )
</td>
<td></td>
<td>
<a href="/statements/2145105547">details</a>
</td>
</tr>
<tr>
<td>
Apple Japan, Inc. (Japan)
</td>
<td></td>
<td>
<a href="/statements/2145105506">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter ie" href="/companies/ie" title="Free And Open Data On Ireland Companies"><img alt="Ireland flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/ie-7b3318a06553e5d3bcbec86548712311.gif" /></a>  <a class="company normal" href="/companies/ie/470672" title="More Free And Open Company Data On APPLE DISTRIBUTION INTERNATIONAL LIMITED (Ireland, 470672)">APPLE DISTRIBUTION INTERNATIONAL LIMITED</a> (Ireland, <span class="start_date">11 May 2009</span>- )
</td>
<td></td>
<td>
<a href="/statements/2145105494">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter ie" href="/companies/ie" title="Free And Open Data On Ireland Companies"><img alt="Ireland flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/ie-7b3318a06553e5d3bcbec86548712311.gif" /></a>  <a class="company normal" href="/companies/ie/492405" title="More Free And Open Company Data On APPLE OPERATIONS LIMITED (Ireland, 492405)">APPLE OPERATIONS LIMITED</a> (Ireland, <span class="start_date"> 8 Dec 2010</span>- )
</td>
<td></td>
<td>
<a href="/statements/2145105524">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/subsidiary_relationship_subject">See all (167 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-trademark_registration'>
<h3>
Trademark registrations
<span class='heading-help'>
<a class='data-type-description' data-content='A trademark is recognizable text, design, image, or sensory mark which identifies products or services of a particular source from those of others' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Trademark registrations'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Mark Text</th>
<th>Image</th>
<th>Register</th>
<th>NICE classifications</th>
<th>Registration Date</th>
<th>Expiry Date</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
MAGSAFE CHARGER
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/90285043/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-06-15
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1079420784">details</a>
</td>
</tr>
<tr>
<td>
NEWS+
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/88560204/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
41, 42
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076301011">details</a>
</td>
</tr>
<tr>
<td>

</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/90014606/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076550800">details</a>
</td>
</tr>
<tr>
<td>
APPLE NEWS+
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/88541065/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
41, 42
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076655065">details</a>
</td>
</tr>
<tr>
<td>
GYMKIT
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/87474480/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-05-18
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1060071857">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/trademark_registration">See all (1561 records)</a>
</div>
</div>
<br>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>

<script>
  window.dataLayer = window.dataLayer || [];
  dataLayer.push({
    event: 'login',
    user_properties: {
      user_id: "0",
      business_id: "",
      business_domain_name: "example.com",
      logged_in: true
    }
  });
</script>

</body>
</html>

test/fixtures/es_80331051.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on Spain company COHER SERVICIOS Y ASISTENCIA SL (company number 80331051)' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, COHER SERVICIOS Y ASISTENCIA SL, Spain' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/es/80331051" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="JYXYBpS/b4u3OVuMnTDL4xxu6vrrPHsjcbcwLIzW2QY=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li><a href="/users/sign_in" rel="nofollow">Log in/Sign up</a></li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
COHER SERVICIOS Y ASISTENCIA SL
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">80331051</dd>






<dt>Company Type</dt> <dd class="company_type">Sociedad Limitada</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter es" href="/companies/es" title="Free And Open Data On Spain Companies">Spain</a></dd>























</dl>
</div>
</div>

<div id='company_data'>
<div id='update_links'></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last update from source</dt>
<dt>Last change recorded</dt>
<dt>Next update from source</dt>
<dt>Source</dt>
<dd>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fes%2F80331051">Please log in to see this data</a>
</dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

</div>
</div>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>


</body>
</html>

test/fixtures/gb_05957738.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on United Kingdom company LIBRA INVESTMENT PROPERTY GROUP LIMITED (company number 05957738), Penycastell Farm
Bryn, Port Talbot, West Glamorgan, SA13 2PY' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, LIBRA INVESTMENT PROPERTY GROUP LIMITED, United Kingdom' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/gb/05957738" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="qVVNGYJ7jXcWDHq5+/5AAETZIXOjIiStNK+cyoFl81s=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li><a href="/users/sign_in" rel="nofollow">Log in/Sign up</a></li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
LIBRA INVESTMENT PROPERTY GROUP LIMITED
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">05957738</dd>



<dt>Status</dt> <dd class="status">Active</dd>
<dt>Incorporation Date</dt> <dd class="incorporation_date"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">Please log in to see this data</a></dd>

<dt>Company Type</dt> <dd class="company_type">Private Limited Company</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies">United Kingdom</a></dd>







<dt>Ultimate Beneficial Owners</dt> <dd class="ultimate_beneficial_owners"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">3 UBOs listed, please log in to see this data</a></dd>
<dt>Registered Address</dt> <dd class="registered_address adr"><ul class="address_lines"><li class="address_line">Penycastell Farm<br />Bryn</li><li class="address_line">Port Talbot</li><li class="address_line">SA13 2PY</li><li class="address_line">West Glamorgan</li><li class="address_line">United Kingdom</li></ul></dd>
<dt>Industry Codes</dt> <dd class="industry_codes"><ul class="attribute_list"><li class="attribute_item">70.10: Activities of head offices (UK SIC Classification 2007)</li><li class="attribute_item">70.10: Activities of head offices (European Community NACE Rev 2)</li><li class="attribute_item">7010: Activities of head offices (UN ISIC Rev 4)</li></ul></dd>


<dt>Latest Accounts Date</dt> <dd class="latest_accounts_date">2025-03-31</dd>
<dt>Annual Return Last Made Up Date</dt> <dd class="annual_return_last_made_up_date">2015-10-05</dd>
<dt>Previous Names</dt> <dd class="previous_names"><ul class="name_lines"><li class="name_line">£IBRA FINANCIAL SERVICES LIMITED</li></ul></dd>




<dt>Directors / Officers</dt> <dd class="officers"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">2 officers available, please log in to see this data</a></dd>

<dt>Inactive Directors / Officers</dt> <dd class="officers"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">3 officers available, please log in to see this data</a></dd>

</dl>
</div>
</div>

<div id='company_data'>
<div id='update_links'></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last update from source</dt>
<dt>Last change recorded</dt>
<dt>Next update from source</dt>
<dt>Source</dt>
<dd>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">Please log in to see this data</a>
</dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_object'>
<h3>
Statements of control (by this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (by this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2016-10-05
</td>
<td>
Mr David Ian Bromley  and Mr David Ian Bromley-Cornfield  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/2255744855">details</a>
</td>
</tr>
<tr>
<td>
2016-10-05
</td>
<td>
Mrs Elizabeth Davies  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/2255744858">details</a>
</td>
</tr>
<tr>
<td>
2016-10-05
</td>
<td>
Mrs Sally-Ann Michelle Bromley  controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td><span class="status label">historic</span> </td>
<td>
<a href="/statements/2255744857">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_subject'>
<h3>
Statements of control (relating to this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (relating to this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2017-01-26
</td>
<td>
<a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/07137174" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES RCT LIMITED (United Kingdom, 07137174)">LIBRA INVESTMENT PROPERTY SERVICES RCT LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1943654210">details</a>
</td>
</tr>
<tr>
<td>
2016-08-02
</td>
<td>
<a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/06331958" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES LIMITED (United Kingdom, 06331958)">LIBRA INVESTMENT PROPERTY SERVICES LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1950321413">details</a>
</td>
</tr>
<tr>
<td>
2016-04-06
</td>
<td>
Libra Investment Property Group Ltd  and <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company active" href="/companies/gb/05957738" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY GROUP LIMITED (United Kingdom, 05957738)">LIBRA INVESTMENT PROPERTY GROUP LIMITED</a> (United Kingdom) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/06925425" title="More Free And Open Company Data On LIBRA INVESTMENT PROPERTY SERVICES WMSA LIMITED (United Kingdom, 06925425)">LIBRA INVESTMENT PROPERTY SERVICES WMSA LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership
</td>
<td></td>
<td>
<a href="/statements/1946685971">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div class='data-table-filing-delegate'>
<h3>
Filings
<span class='heading-help'>
<a class='data-type-description' data-content='Filings are official documents filed with a publisher who usually has regulatory powers' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Filings'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fgb%2F05957738">71 filings available, please log in to see this information</a>
</div>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-industry_code'>
<h3>
Industry codes
<span class='heading-help'>
<a class='data-type-description' data-content='A classification denoting the industry or sector a company is in, according to a specific code list (e.g. NAICS, NACE)' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Industry codes'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Code</th>
<th>Description</th>
<th>Code scheme</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
70.10
</td>
<td>
Activities of head offices
</td>
<td>
UK SIC Classification 2007
</td>
<td></td>
<td>
<a href="/statements/60311892">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<br>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>


</body>
</html>

test/fixtures/nl_17087985.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on Netherlands company Bover B.V. (company number 17087985), Ceresstraat 13, Breda, 4811CA' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, Bover B.V., Netherlands' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/nl/17087985" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="U2lPliakgDETSm6qAenhSjoG7Cqr7C5aHAXK/Fz3loQ=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li><a href="/users/sign_in" rel="nofollow">Log in/Sign up</a></li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
Bover B.V.
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">17087985</dd>


<dt>Other Identifiers</dt> <dd class="other_identifiers"><ul class="attribute_list"><li class="attribute_item"><a class="identifier" href="/identifiers/cik/1434782" title="US Securities And Exchange Commission CIK number: 1434782">SEC CIK number: 1434782</a></li></ul></dd>
<dt>Status</dt> <dd class="status">Active</dd>


<dt>Company Type</dt> <dd class="company_type">Besloten Vennootschap</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter nl" href="/companies/nl" title="Free And Open Data On Netherlands Companies">Netherlands</a></dd>
<dt>Restricted</dt> <dd class="restricted">This company has activated a Non Mailing Indicator (NMI) to indicate that they do not wish to receive unsolicited mail or sales visits. Their registered address should not be used for this purpose. See: <a href="https://www.kvk.nl/english/report-a-change/protecting-your-data-with-the-non-mailing-indicator/">https://www.kvk.nl/english/report-a-change/protecting-your-data-with-the-non-mailing-indicator/</a></dd>








<dt>Registered Address</dt> <dd class="registered_address adr"><ul class="address_lines"><li class="address_line">Ceresstraat 13</li><li class="address_line">Breda</li><li class="address_line">4811CA</li><li class="address_line">Netherlands</li></ul></dd>














</dl>
</div>
</div>

<div id='company_data'>
<div id='update_links'></div>
<div id="assertions"><div class="assertion_group" id="company_addresses"><h3>Company Addresses</h3><div class="assertion company_address" id="assertion_2457731"><div class='subhead'>
<a href="/data/2457731">Company Address</a>
</div>
<p class='description'>
BOKSHEIDE 20, EERSEL P7 5521 PM
</p>
</div><div class="assertion company_address" id="assertion_46897397"><div class='subhead'>
<a href="/data/46897397">Head Office Address</a>
</div>
<p class='description'>
Cimburgalaan 84, Breda, 4819BD
</p>
</div></div><div class="assertion_group" id="official_register_entries"><h3>Official Register Entries</h3><div class="assertion official_register_entry" id="assertion_2457732"><div class='subhead'>
<a href="/data/2457732">SEC Edgar entry</a>
</div>
<p class='description'>
register id: 1434782
</p>
</div></div></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last update from source</dt>
<dt>Last change recorded</dt>
<dt>Next update from source</dt>
<dt>Source</dt>
<dd>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fnl%2F17087985">Please log in to see this data</a>
</dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

<div class='sidebar'>
<div class='sidebar-item' id='similarly_named'>
<h3><a href="/companies?q=Bover+B.V." title="Companies named Bover B.V.">Similarly named companies</a></h3>
<ul class='companies'>
<li class='active'>
<a class="jurisdiction_filter nl" href="/companies/nl" title="Free And Open Data On Netherlands Companies"><img alt="Netherlands flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/nl-400a4ebe87ae4f60142ca65df8c67f0f.gif" /></a>  <a class="company active" href="/companies/nl/87153726" title="More Free And Open Company Data On BoVer Shipping B.V. (Netherlands, 87153726)">BoVer Shipping B.V.</a> (Netherlands)
</li>
<li class='active'>
<a class="jurisdiction_filter nl" href="/companies/nl" title="Free And Open Data On Netherlands Companies"><img alt="Netherlands flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/nl-400a4ebe87ae4f60142ca65df8c67f0f.gif" /></a>  <a class="company active" href="/companies/nl/68891210" title="More Free And Open Company Data On Bover Consultants B.V. (Netherlands, 68891210)">Bover Consultants B.V.</a> (Netherlands)
</li>
<li class='active'>
<a class="jurisdiction_filter nl" href="/companies/nl" title="Free And Open Data On Netherlands Companies"><img alt="Netherlands flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/nl-400a4ebe87ae4f60142ca65df8c67f0f.gif" /></a>  <a class="company active" href="/companies/nl/80590934" title="More Free And Open Company Data On Bover Invest B.V. (Netherlands, 80590934)">Bover Invest B.V.</a> (Netherlands)
</li>
</ul>
</div>

</div>
</div>
</div>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>


</body>
</html>

test/fixtures/us_ca_C0806592.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on California (US) company APPLE INC. (company number 0806592), ONE APPLE PARK WAY, CUPERTINO, CA, 95014' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, APPLE INC., California (US)' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/us_ca/0806592" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="fdGgxvpqx+J1q92vgzRkCWYBggNX3CKhfBW0yWmRhyE=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li><a href="/users/sign_in" rel="nofollow">Log in/Sign up</a></li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
APPLE INC.
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">0806592</dd>

<dt>Previous Company Numbers</dt> <dd class="previous_company_numbers"><ul class="attribute_list"><li class="attribute_item">C0806592</li></ul></dd>
<dt>Other Identifiers</dt> <dd class="other_identifiers"><ul class="attribute_list"><li class="attribute_item"><a class="identifier" href="/identifiers/cage/58839" title="US Federal &#39;Commercial And Government Entity&#39; Register: 58839">US Federal CAGE number: 58839</a></li><li class="attribute_item"><a class="identifier" href="/identifiers/cik/320193" title="US Securities And Exchange Commission CIK number: 320193">SEC CIK number: 320193</a></li><li class="attribute_item"><a class="identifier" href="/identifiers/fein/942404110" title="US Federal Employee Identification Number: 942404110">US EIN number: 942404110</a></li></ul></dd>
<dt>Status</dt> <dd class="status">Active</dd>
<dt>Incorporation Date</dt> <dd class="incorporation_date"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_ca%2F0806592">Please log in to see this data</a></dd>

<dt>Company Type</dt> <dd class="company_type">Stock Corporation - CA - General</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies">California (US)</a></dd>








<dt>Registered Address</dt> <dd class="registered_address adr"><ul class="address_lines"><li class="address_line">ONE APPLE PARK WAY</li><li class="address_line">CUPERTINO</li><li class="address_line">95014</li><li class="address_line">CA</li><li class="address_line">United States</li></ul></dd>








<dt>Agent Name</dt> <dd class="agent_name">C T CORPORATION SYSTEM</dd>
<dt>Agent Address</dt> <dd class="agent_address">330 N BRAND BLVD STE # 700, GLENDALE, CA, 91203, UNITED STATES</dd>
<dt>Directors / Officers</dt> <dd class="officers"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_ca%2F0806592">25 officers available, please log in to see this data</a></dd>

<dt>Inactive Directors / Officers</dt> <dd class="officers"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_ca%2F0806592">29 officers available, please log in to see this data</a></dd>

</dl>
</div>
</div>

<div id='filings'>
<div class='rss_feed'><a href="/companies/us_ca/0806592/filings.rss" title="Subscribe to filings for APPLE INC."><img alt="RSS feed icon" src="https://cdn.opencorporates.com/assets/feed_icon-67c607b1dae7bfb208b04acfe9a07e50.gif" /></a></div>
<h3><a href="https://opencorporates.com/companies/us_ca/0806592/filings" title="See all filings for APPLE INC.">Recent filings for APPLE INC.</a></h3>
<div class="filing" id="filing_1070407905"><div class='dateline'>28 Jan 2022</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/1070407905" title="more info on PUBLICLY TRADED DISCLOSURE">PUBLICLY TRADED DISCLOSURE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_1076962611"><div class='dateline'>27 Jan 2022</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/1076962611" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_986944551"><div class='dateline'> 9 Jul 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/986944551" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_979103133"><div class='dateline'> 8 Jul 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/979103133" title="more info on FILING OFFICE STATEMENT">FILING OFFICE STATEMENT</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_699793136"><div class='dateline'> 9 Mar 2021</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/699793136" title="more info on PUBLICLY TRADED DISCLOSURE">PUBLICLY TRADED DISCLOSURE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_986944548"><div class='dateline'> 8 Dec 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/986944548" title="more info on SI-COMPLETE">SI-COMPLETE</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_676506521"><div class='dateline'> 3 Aug 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/676506521" title="more info on RESTATED REGISTRATION">RESTATED REGISTRATION</a>
</div>
<p class='description'>

</p>
</div>
</div><div class="filing" id="filing_676506518"><div class='dateline'> 3 Aug 2020</div>
<div class='info'>
<div class='subhead'>
<a class="filing" href="/filings/676506518" title="more info on AMENDMENT">AMENDMENT</a>
</div>
<p class='description'>

</p>
</div>
</div>
<p class='more_info'><a href="https://opencorporates.com/companies/us_ca/0806592/filings">see all filings</a></p>
</div>
<div id='company_data'>
<div id='update_links'></div>
<div id="assertions"><div class="assertion_group" id="company_addresses"><h3>Company Addresses</h3><div class="summary"><a href="/data?assertion_type=CompanyAddress&amp;company_id%5B%5D=23317130">506</a> Company Addresses, showing 10 most recently added</div><div class="assertion company_address" id="assertion_44563177"><div class='subhead'>
<a href="/data/44563177">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_44564184"><div class='subhead'>
<a href="/data/44564184">Company Address</a>
</div>
<p class='description'>
1 INFINITE LOOP, CUPERTINO CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_45344563"><div class='subhead'>
<a href="/data/45344563">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47902646"><div class='subhead'>
<a href="/data/47902646">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47908349"><div class='subhead'>
<a href="/data/47908349">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_47973669"><div class='subhead'>
<a href="/data/47973669">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_48623831"><div class='subhead'>
<a href="/data/48623831">Company Address</a>
</div>
<p class='description'>
1 Infinite Loop, Cupertino CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_49213402"><div class='subhead'>
<a href="/data/49213402">Company Address</a>
</div>
<p class='description'>
1 INFINITE LOOP, CUPERTINO CA 95014, US
</p>
</div><div class="assertion company_address" id="assertion_49687945"><div class='subhead'>
<a href="/data/49687945">Mailing Address</a>
</div>
<p class='description'>
ONE APPLE PARK WAY, CUPERTINO, CA, 95014, United States
</p>
</div><div class="assertion company_address" id="assertion_160580885"><div class='subhead'>
<a href="/data/160580885">Head Office Address</a>
</div>
<p class='description'>
ONE APPLE PARK WAY, CUPERTINO, CA, 95014, United States
</p>
</div></div><div class="assertion_group" id="websites"><h3>Websites</h3><div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/4912925">Website</a>
</div>
<p class='description'>
<a class="external" href="http://www.apple.com/federal/" rel="nofollow">http://www.apple.com/federal/</a>
</p>
</div>
<div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/5400399">Website</a>
</div>
<p class='description'>
<a class="external" href="http://www.apple.com/federal/" rel="nofollow">http://www.apple.com/federal/</a>
</p>
</div>
<div class='assertion'>
<div class='subhead'>
<a href="https://opencorporates.com/data/10086458">Website</a>
</div>
<p class='description'>
<a class="external" href="https://www.apple.com/" rel="nofollow">https://www.apple.com/</a>
</p>
</div>
</div><div class="assertion_group" id="government_approved_suppliers"><h3>Approved Government Suppliers</h3><div class="assertion government_approved_supplier" id="assertion_2685133"><div class='subhead'>
<a href="/data/2685133">Approved US Government Supplier</a>
</div>
<p class='description'>

</p>
</div></div><div class="assertion_group" id="official_register_entries"><h3>Official Register Entries</h3><div class="assertion official_register_entry" id="assertion_3805853"><div class='subhead'>
<a href="/data/3805853">SEC Edgar entry</a>
</div>
<p class='description'>
register id: 320193
</p>
</div></div><div class="assertion_group" id="telephone_numbers"><h3>Telephone Numbers</h3><div class="assertion telephone_number" id="assertion_4912926"><div class='subhead'>
<a href="/data/4912926">Telephone Number</a>
</div>
<p class='description'>
Number: +1 7032643249
</p>
</div></div><div class="assertion_group" id="tax_numbers"><h3>Tax Numbers</h3><div class="assertion tax_number" id="assertion_7825775"><div class='subhead'>
<a href="/data/7825775">Tax Number</a>
</div>
<p class='description'>
US EIN number: 942404110
</p>
</div></div></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last update from source</dt>
<dt>Last change recorded</dt>
<dt>Next update from source</dt>
<dt>Source</dt>
<dd>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_ca%2F0806592">Please log in to see this data</a>
</dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

<div class='sidebar'>
<div class='sidebar-item' id='similarly_named'>
<h3><a href="/companies?q=APPLE+INC." title="Companies named APPLE INC.">Similarly named companies</a></h3>
<p>
<a href="/companies?q=APPLE+INC." title="Companies named APPLE INC.">Found 13447.</a>
Showing first 10
</p>
<ul class='companies'>
<li class='delinquent'>
<a class="jurisdiction_filter us" href="/companies/us_co" title="Free And Open Data On Colorado (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company delinquent" href="/companies/us_co/20251545548" title="More Free And Open Company Data On black apple incorporated (Colorado (US), 20251545548)">black apple incorporated</a> (Colorado (US))
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0450480559" title="More Free And Open Company Data On MAMMEE APPLE INCORPORATED (New Jersey (US), 0450480559)">MAMMEE APPLE INCORPORATED</a> (New Jersey (US))
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_de" title="Free And Open Data On Delaware (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_de/2842501" title="More Free And Open Company Data On CHERRY APPLE INCORPORATED (Delaware (US), 2842501)">CHERRY APPLE INCORPORATED</a> (Delaware (US))
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0100512323" title="More Free And Open Company Data On ASA APPLE INCORPORATED (New Jersey (US), 0100512323)">ASA APPLE INCORPORATED</a> (New Jersey (US))
</li>
<li class='active/compliance'>
<a class="jurisdiction_filter us" href="/companies/us_ga" title="Free And Open Data On Georgia (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active/compliance" href="/companies/us_ga/21312615" title="More Free And Open Company Data On GRAVITY APPLE, Incorporated (Georgia (US), 21312615)">GRAVITY APPLE, Incorporated</a> (Georgia (US))
</li>
<li class='active'>
<a class="jurisdiction_filter us" href="/companies/us_ny" title="Free And Open Data On New York (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ny/7879815" title="More Free And Open Company Data On PINK APPLE INCORPORATED (New York (US), 7879815)">PINK APPLE INCORPORATED</a> (New York (US))
</li>
<li>
<a class="jurisdiction_filter us" href="/companies/us_nj" title="Free And Open Data On New Jersey (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_nj/0400299318" title="More Free And Open Company Data On WILD APPLE INCORPORATED (New Jersey (US), 0400299318)">WILD APPLE INCORPORATED</a> (New Jersey (US))
</li>
<li class='multiple'>
<a class="jurisdiction_filter us" href="/companies/us_nc" title="Free And Open Data On North Carolina (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company multiple" href="/companies/us_nc/0347181" title="More Free And Open Company Data On MARK A. APPLE, INCORPORATED (North Carolina (US), 0347181)">MARK A. APPLE, INCORPORATED</a> (North Carolina (US))
</li>
<li class='active'>
<a class="jurisdiction_filter us" href="/companies/us_ny" title="Free And Open Data On New York (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">nonprofit</span>  <a class="company active" href="/companies/us_ny/4733087" title="More Free And Open Company Data On FEEDING THE BIG APPLE INCORPORATED (New York (US), 4733087)">FEEDING THE BIG APPLE INCORPORATED</a> (New York (US))
</li>
<li class='inactive voluntarily_dissolved'>
<a class="jurisdiction_filter us" href="/companies/us_mo" title="Free And Open Data On Missouri (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company inactive voluntarily_dissolved" href="/companies/us_mo/00399397" title="More Free And Open Company Data On APPLE INCORPORATED (Missouri (US), 00399397)">APPLE INCORPORATED</a> (Missouri (US))
</li>
</ul>
</div>

</div>
</div>
</div>
<div class='row'>
<div class='span12'>
<div id='data-table-branch_relationship_subject'>
<h3>
Branches
<span class='heading-help'>
<a class='data-type-description' data-content='A branch company is an out-of-jurisdiction registration of a company (in the US it is often referred to as a &#39;Foreign Corporation&#39;)' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Branches'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
</thead>
<tbody>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ar" title="Free And Open Data On Arkansas (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch good_standing" href="/companies/us_ar/811516357" title="More Free And Open Company Data On APPLE COMPUTER INC. (Arkansas (US), 811516357)">APPLE COMPUTER INC.</a> (Arkansas (US))
</td>
<td></td>
<td>
<a href="/statements/1915384745">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ky" title="Free And Open Data On Kentucky (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch active" href="/companies/us_ky/0654776" title="More Free And Open Company Data On APPLE INC. (Kentucky (US), 0654776)">APPLE INC.</a> (Kentucky (US))
</td>
<td></td>
<td>
<a href="/statements/72990646">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_me" title="Free And Open Data On Maine (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch good_standing" href="/companies/us_me/20140693F" title="More Free And Open Company Data On APPLE INC. (Maine (US), 20140693F)">APPLE INC.</a> (Maine (US))
</td>
<td></td>
<td>
<a href="/statements/578346333">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_wa" title="Free And Open Data On Washington (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company branch active" href="/companies/us_wa/600518265" title="More Free And Open Company Data On APPLE INC. (Washington (US), 600518265)">APPLE INC.</a> (Washington (US))
</td>
<td></td>
<td>
<a href="/statements/8015291">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter us" href="/companies/us_me" title="Free And Open Data On Maine (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a> <span class="status label">branch</span>  <a class="company inactive branch authority_revoked" href="/companies/us_me/20090379F" title="More Free And Open Company Data On APPLE INC. (Maine (US), 20090379F)">APPLE INC.</a> (Maine (US))
</td>
<td></td>
<td>
<a href="/statements/578554290">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/branch_relationship_subject">See all (64 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-control_statement_subject'>
<h3>
Statements of control (relating to this company)
<span class='heading-help'>
<a class='data-type-description' data-content='A ControlStatement is a declaration by a company or entity about how it is controlled. A company may have multiple entities controlling it (entites may be companies, people or organisations), in which case there will be multiple statements of control, or may have no entity controlling it in which case the statement can detail this fact together with the reasons. The controlling entities will be &#39;ultimate beneficial owners&#39; if the company is stating that the controlling entities are natural persons who ultimately control the company in some way' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Statements of control (relating to this company)'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Date</th>
<th>Description</th>
<th>Mechanisms</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
2022-06-09
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US)) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/14162167" title="More Free And Open Company Data On APPLE TECHNOLOGY U.K. LIMITED (United Kingdom, 14162167)">APPLE TECHNOLOGY U.K. LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1949281745">details</a>
</td>
</tr>
<tr>
<td>
2022-01-21
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US)) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/10733886" title="More Free And Open Company Data On AI MUSIC LIMITED (United Kingdom, 10733886)">AI MUSIC LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1938179504">details</a>
</td>
</tr>
<tr>
<td>
2020-08-21
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US)) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/07768047" title="More Free And Open Company Data On SHAZAM INVESTMENTS LIMITED (United Kingdom, 07768047)">SHAZAM INVESTMENTS LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1933901336">details</a>
</td>
</tr>
<tr>
<td>
2020-03-05
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US)) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/SC573253" title="More Free And Open Company Data On VOYSIS UK LIMITED (United Kingdom, SC573253)">VOYSIS UK LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1937636993">details</a>
</td>
</tr>
<tr>
<td>
2019-11-08
</td>
<td>
<a class="jurisdiction_filter us" href="/companies/us_ca" title="Free And Open Data On California (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company active" href="/companies/us_ca/0806592" title="More Free And Open Company Data On APPLE INC. (California (US), 0806592)">APPLE INC.</a> (California (US)) controls <a class="jurisdiction_filter gb" href="/companies/gb" title="Free And Open Data On United Kingdom Companies"><img alt="United Kingdom flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/gb-7c3c930763931dcc85831a74b53a4df1.gif" /></a>  <a class="company inactive dissolved" href="/companies/gb/07538488" title="More Free And Open Company Data On SPECTRAL EDGE LIMITED (United Kingdom, 07538488)">SPECTRAL EDGE LIMITED</a> (United Kingdom)
</td>
<td>
Share Ownership, Voting Rights, Right To Appoint And Remove Directors
</td>
<td></td>
<td>
<a href="/statements/1966116344">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/control_statement_subject">See all (11 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-subsidiary_relationship_subject'>
<h3>
Subsidiaries
<span class='heading-help'>
<a class='data-type-description' data-content='A subsidiary is a company that is controlled by another company. Often the control is exerted via a majority shareholding, but can be via other mechanisms. It can also be exerted via shareholdings in other companies. When this happens, we call it an indirect subsidiary. Subsidiary information often comes from official annual reports. Companies are only obliged to report &#39;significant&#39; subsidiaries, and the definition of &#39;significant&#39; is not consistent.' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Subsidiaries'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
</thead>
<tbody>
<tr>
<td>
Apple Vietnam Limited Liability Company (Viet Nam)
</td>
<td></td>
<td>
<a href="/statements/2145105551">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter sg" href="/companies/sg" title="Free And Open Data On Singapore Companies"><img alt="Singapore flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/sg-2c4a0655b0b8c61bfb70a2c73f862180.gif" /></a>  <a class="company live_company" href="/companies/sg/198903166R" title="More Free And Open Company Data On APPLE SOUTH ASIA PTE. LTD. (Singapore, 198903166R)">APPLE SOUTH ASIA PTE. LTD.</a> (Singapore)
</td>
<td></td>
<td>
<a href="/statements/2145105547">details</a>
</td>
</tr>
<tr>
<td>
Apple Japan, Inc. (Japan)
</td>
<td></td>
<td>
<a href="/statements/2145105506">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter ie" href="/companies/ie" title="Free And Open Data On Ireland Companies"><img alt="Ireland flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/ie-7b3318a06553e5d3bcbec86548712311.gif" /></a>  <a class="company normal" href="/companies/ie/470672" title="More Free And Open Company Data On APPLE DISTRIBUTION INTERNATIONAL LIMITED (Ireland, 470672)">APPLE DISTRIBUTION INTERNATIONAL LIMITED</a> (Ireland)
</td>
<td></td>
<td>
<a href="/statements/2145105494">details</a>
</td>
</tr>
<tr>
<td>
<a class="jurisdiction_filter ie" href="/companies/ie" title="Free And Open Data On Ireland Companies"><img alt="Ireland flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/ie-7b3318a06553e5d3bcbec86548712311.gif" /></a>  <a class="company normal" href="/companies/ie/492405" title="More Free And Open Company Data On APPLE OPERATIONS LIMITED (Ireland, 492405)">APPLE OPERATIONS LIMITED</a> (Ireland)
</td>
<td></td>
<td>
<a href="/statements/2145105524">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/subsidiary_relationship_subject">See all (167 records)</a>
</div>
</div>
<br>
<div class='row'>
<div class='span12'>
<div id='data-table-trademark_registration'>
<h3>
Trademark registrations
<span class='heading-help'>
<a class='data-type-description' data-content='A trademark is recognizable text, design, image, or sensory mark which identifies products or services of a particular source from those of others' data-html='true' data-placement='right' data-toggle='popover' data-trigger='hover' href='' rel='popover' title='Trademark registrations'>
<i class='icon-question-sign'></i>
</a>
</span>
</h3>
<div class='table-wrapper'>
<table class='table table-condensed table-striped company-data-object'>
<thead>
<tr>
<th>Mark Text</th>
<th>Image</th>
<th>Register</th>
<th>NICE classifications</th>
<th>Registration Date</th>
<th>Expiry Date</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>
MAGSAFE CHARGER
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/90285043/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-06-15
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1079420784">details</a>
</td>
</tr>
<tr>
<td>
NEWS+
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/88560204/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
41, 42
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076301011">details</a>
</td>
</tr>
<tr>
<td>

</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/90014606/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076550800">details</a>
</td>
</tr>
<tr>
<td>
APPLE NEWS+
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/88541065/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
41, 42
</td>
<td>
2021-06-08
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1076655065">details</a>
</td>
</tr>
<tr>
<td>
GYMKIT
</td>
<td>
<img alt="Large" src="http://tsdr.uspto.gov/img/87474480/large" />
</td>
<td>
United States Patent and Trademark Office
</td>
<td>
9
</td>
<td>
2021-05-18
</td>
<td>

</td>
<td></td>
<td>
<a href="/statements/1060071857">details</a>
</td>
</tr>
</tbody>
</table>
</div>
</div>

</div>
</div>
<div class='row'>
<div class='span12'>
<a href="/companies/us_ca/0806592/statements/trademark_registration">See all (1561 records)</a>
</div>
</div>
<br>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>


</body>
</html>

test/fixtures/us_de_2138865.html

<!DOCTYPE html>
<html>
<head>
<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
        new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
    j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
    'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-MDHMHCR');</script>
<!-- End Google Tag Manager -->

<title>
Entity Details :: OpenCorporates
</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type'>
<meta content='Free and open company data on Delaware (US) company SUSSEX TREE, INC. (company number 2138865)' name='description'>
<meta content='company data, company information, open data, company register, linked data, free data, SUSSEX TREE, INC., Delaware (US)' name='keywords'>
<meta content='width=device-width, initial-scale=1.0' name='viewport'>
<link as='style' href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' rel='preload'>
<link href='https://fonts.googleapis.com/css?family=Roboto&amp;amp;display=swap&amp;amp;ver=1686576272' media='all' onload='this.media=&#39;all&#39;' rel='stylesheet'>
<link href='https://fonts.googleapis.com/css?family=Roboto%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic%7CRoboto+Slab%3A100%2C100italic%2C200%2C200italic%2C300%2C300italic%2C400%2C400italic%2C500%2C500italic%2C600%2C600italic%2C700%2C700italic%2C800%2C800italic%2C900%2C900italic&amp;amp;display=swap&amp;amp;ver=6.3.4' id='google-fonts-1-css' media='all' rel='stylesheet' type='text/css'>
<link href='/assets/favicons/favicon.ico' rel='icon' type='image/x-icon'>
<link href='/assets/favicons/favicon.png' rel='icon' type='image/png'>
<link href='/assets/favicons/apple-touch-icon-152x152.png' rel='apple-touch-icon' sizes='152x152'>
<link href='/assets/favicons/apple-touch-icon-144x144.png' rel='apple-touch-icon' sizes='144x144'>
<link href='/assets/favicons/apple-touch-icon-120x120.png' rel='apple-touch-icon' sizes='120x120'>
<link href='/assets/favicons/apple-touch-icon-114x114.png' rel='apple-touch-icon' sizes='114x114'>
<link href='/assets/favicons/apple-touch-icon-76x76.png' rel='apple-touch-icon' sizes='76x76'>
<link href='/assets/favicons/apple-touch-icon-72x72.png' rel='apple-touch-icon' sizes='72x72'>
<link href='/assets/favicons/apple-touch-icon-57x57.png' rel='apple-touch-icon' sizes='57x57'>
<link href="https://opencorporates.com/companies/us_de/2138865" rel="canonical" />
<meta content="authenticity_token" name="csrf-param" />
<meta content="rUK9J9evJAaZHzueEjXsD6kp4Q7iDWUp1upt1ezS8k4=" name="csrf-token" />
<script src="https://cdn.opencorporates.com/assets/application-0b2431cec24c85fe472386ac49ac89a3.js"></script>

<!--[if lt IE 9]>
<script src="https://cdn.opencorporates.com/assets/html5shiv-8cf88834d0a9d50544e8fa98249b23cd.js"></script>
<![endif]-->
<script id='cookieyes' src='https://cdn-cookieyes.com/client_data/0c7e2a1b343978e408eb46cb/script.js' type='text/javascript'></script>
<script async defer src='https://www.google.com/recaptcha/enterprise.js?render=6Lcn7OEtAAAAAFiJgc1eesGfuaTsyDsVCNZx5Pck&amp;waf=session'></script>


<link href="https://cdn.opencorporates.com/assets/application-c10d964058caca4fececcbdcc6a399d0.css" media="screen, projection" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/print-2f8179a518a24471b8cbe44a4a67f343.css" media="print" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/new-ffbbc42555b92d66fa8f2c5ab952361c.css" media="screen" rel="stylesheet" />
<link href="https://cdn.opencorporates.com/assets/fixes/bridge-e6e922221a9d2e13e5fdab772fb25dd8.css" media="screen" rel="stylesheet" />
<!--[if IE 7]>
<link href="https://cdn.opencorporates.com/assets/ie7-520cbe3639fc3ade2c41b8912d2e2c0b.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if IE 8]>
<link href="https://cdn.opencorporates.com/assets/ie8-966fec58af59590e64fdd3d5e79c44a0.css" media="screen, projection" rel="stylesheet" />
<![endif]-->
<!--[if lte IE 8]>
<link href="https://cdn.opencorporates.com/assets/fixes/lte-ie8-bridge-f160490a92a5cb43746c0851abbdf805.css" media="screen" rel="stylesheet" />
<![endif]-->

</head>
<body class='companies'>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-MDHMHCR"
                  height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<!-- End Google Tag Manager (noscript) -->

<header class='oc-header'>
<div class='oc-header__container'>
<div class='oc-header__left'>
<a class="oc-header__link" href="/"><img alt="OpenCorporates" class="oc-header__logo" onerror="this.src=&quot;https://cdn.opencorporates.com/assets/components/oc-header/logo-90106189816f235c54a35d3e547a9408.png&quot;; this.onerror=null;" src="https://cdn.opencorporates.com/assets/components/oc-header/logo-2efd52254fd412454458f27c35639d3a.svg" />
</a><div class='oc-header__tagline'>The Open Database Of The Corporate World</div>
</div>
<div class='oc-header__middle'>
<div class='oc-header-search'>
<form accept-charset="UTF-8" action="/search" class="oc-header-search__form js-oc-search-form" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
<div class='oc-header-search__field'>
<input autofocus class='oc-header-search__input js-oc-search-input' name='q' placeholder='Company name or number'>
<button class='oc-header-search__button'>Search</button>
</div>
<div class='oc-header-search__options'>
<label class='oc-header-search__option'>
<input checked class='oc-header-search__radio js-oc-search-radio' data-placeholder='Company name or number' name='type' type='radio' value='companies'>
Companies
</label>
<label class='oc-header-search__option'>
<input class='oc-header-search__radio js-oc-search-radio' data-placeholder='Officer’s name' name='type' type='radio' value='officers'>
Officers
</label>
</div>
</form>

</div>

</div>
<div class='oc-header__right'>
<div class='oc-header__right__bottom'>
<ul class='oc-user-links'>
<li><a href="/users/sign_in" rel="nofollow">Log in/Sign up</a></li>
</ul>

</div>
</div>
</div>
<div class='oc-header__separator'></div>
</header>

<div class='container plain_background' id='page_container'>
<div class='oc-messages'></div>

<div class='row content main_content'>
<div class='span7'>
<div class='vcard' itemscope itemtype='http://schema.org/Corporation'>
<h1 class='wrapping_heading fn org' itemprop='name'>
SUSSEX TREE, INC.
</h1>
<div id='attributes'>
<dl class='attributes dl-horizontal'>
<dt>Company Number</dt> <dd class="company_number">2138865</dd>




<dt>Incorporation Date</dt> <dd class="incorporation_date"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_de%2F2138865">Please log in to see this data</a></dd>

<dt>Company Type</dt> <dd class="company_type">Corporation</dd>
<dt>Jurisdiction</dt> <dd class="jurisdiction"><a class="jurisdiction_filter us" href="/companies/us_de" title="Free And Open Data On Delaware (US) Companies">Delaware (US)</a></dd>

















<dt>Agent Name</dt> <dd class="agent_name">JEFF MEREDITH</dd>
<dt>Agent Address</dt> <dd class="agent_address">24016 SNUG HARBOR CIRCLE, SEAFORD, Sussex, DE, 19973</dd>
<dt>Directors / Officers</dt> <dd class="officers"><a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_de%2F2138865">1 officer available, please log in to see this data</a></dd>



</dl>
</div>
</div>

<div id='company_data'>
<div id='update_links'></div>
</div>

</div>
<div class='span5'>
<div class='sidebar freshness'>
<div class='sidebar-item'>
<span class='define'>Data source and freshness</span>
<dl class='attributes dl-horizontal'>
<dt>Last update from source</dt>
<dt>Last change recorded</dt>
<dt>Next update from source</dt>
<dt>Source</dt>
<dd>
<a href="/users/sign_in?redirect_to=%2Fcompanies%2Fus_de%2F2138865">Please log in to see this data</a>
</dd>
</dl>
<div class='freshness-footer'>
<a href='/legal-entity-data-principles/'>
Learn more about our trust and data transparency policy
</a>
</div>
</div>
</div>

<div class='sidebar-marketing-message'>
<div class='smm-header'>
<p>
<strong>Interested in using our data at scale?</strong>
</p>
<p>Get fresh, standardized, and traceable data directly into your workflows.</p>
</div>
<div class='smm-body'>
<div class='smm-top-panel'>
<div class='smm-top-panel-text'>
<p>Access complete registry updates instantly through our trial services:</p>
</div>
<div class='sml-icon-panel'>
<p>
<img alt="Automate live data via our API" src="https://cdn.opencorporates.com/assets/components/icons/play-aaa1adc65ff543b218199cc3f3a6d506.svg" />
<a aria-label='Automate live data via our API (opens in a new tab)' href='https://opencorporates.com/pricing/' target='_blank'>
<strong>Automate live data via our API</strong>
<span>Integrate and test real-time workflows instantly.</span>
</a>
</p>
<p>
<img alt="Download sample data for bulk" src="https://cdn.opencorporates.com/assets/components/icons/download-8ae2580de9e6c4b9a409ca13427bc9b9.svg" />
<a aria-label='Download sample data for bulk (opens in a new tab)' href='https://landing.opencorporates.com/sample-data-warm' target='_blank'>
<strong>Download sample data for bulk</strong>
<span>Get clean CSV formats to evaluate performance at scale.</span>
</a>
</p>
</div>
</div>
</div>
</div>

<div class='sidebar'>
<div class='sidebar-item' id='similarly_named'>
<h3><a href="/companies?q=SUSSEX+TREE%2C+INC." title="Companies named SUSSEX TREE, INC.">Similarly named companies</a></h3>
<ul class='companies'>
<li>
<a class="jurisdiction_filter us" href="/companies/us_de" title="Free And Open Data On Delaware (US) Companies"><img alt="United States flag" class="flag" src="https://cdn.opencorporates.com/assets/flags/us-8faa0d1ac908e9df673711d795a6a0e6.gif" /></a>  <a class="company" href="/companies/us_de/3474792" title="More Free And Open Company Data On SUSSEX TREE SERVICE, INC. (Delaware (US), 3474792)">SUSSEX TREE SERVICE, INC.</a> (Delaware (US))
</li>
</ul>
</div>

</div>
</div>
</div>

<div class='row prefooter'>
<div class='span12'>
<div class='explanation'>
<a name='explanation'></a>
* While we strive to keep this information correct and up-to-date, it is not the primary source, and the company registry should always be referred to for definitive information
</div>

</div>
</div>
</div>
<div class='oc-footer-marketing-message'>
<div class='oc-fmm-header'>
<div class='oc-fmm-header-title'>
PROVEN AS THE FOUNDATIONAL DATA LAYER FOR
</div>
</div>
<div class='oc-fmm-body oc-fmm-body--carousel oc-fmm-body--pause-on-hover' style='--oc-fmm-carousel-duration: 45s; --oc-fmm-logo-height: 32px; --oc-fmm-carousel-gap: 40px;'>
<div class='oc-fmm-carousel'>
<div class='oc-fmm-carousel__track'>
<div class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
<div aria-hidden class='oc-fmm-carousel__group'>
<div class='oc-fmm-carousel__item'>
<img alt="GAO" src="https://cdn.opencorporates.com/assets/components/customer_logos/3-d7ff3afbc88ec200828953b976b62394.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Swift" src="https://cdn.opencorporates.com/assets/components/customer_logos/5-919d95b1bd3764dc426e28d0eda6befd.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Quantexa" src="https://cdn.opencorporates.com/assets/components/customer_logos/6-b1f9a343165c2fb5743eba3282befd41.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Adyn" src="https://cdn.opencorporates.com/assets/components/customer_logos/7-65a76ed853165b50027407f90c503042.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Flexport" src="https://cdn.opencorporates.com/assets/components/customer_logos/9-e29cdfb177902027483b18b0d5c151b4.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Hummingbird" src="https://cdn.opencorporates.com/assets/components/customer_logos/10-0a000a61f6e692d6300ed95f58ce09ed.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Homeland Security" src="https://cdn.opencorporates.com/assets/components/customer_logos/11-adc3e958888805dfdc051b33af594d62.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="PWC" src="https://cdn.opencorporates.com/assets/components/customer_logos/12-c43131dd796539da747218cb41f69955.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Manulife" src="https://cdn.opencorporates.com/assets/components/customer_logos/13-cd4e0f571911c496bb489ff0e7274b2e.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="Berkshire Hathaway" src="https://cdn.opencorporates.com/assets/components/customer_logos/14-9ce5fbb780ac292548e05298c6764d49.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="NICB" src="https://cdn.opencorporates.com/assets/components/customer_logos/15-731b71356730bfc12eaacaa8f5cf3d84.svg" />
</div>
<div class='oc-fmm-carousel__item'>
<img alt="WayFlyer" src="https://cdn.opencorporates.com/assets/components/customer_logos/16-a600880ff6fcf859e4e85ea886f76114.svg" />
</div>
</div>
</div>
</div>
</div>
</div>

<footer class='oc-footer'>
<div class='oc-footer__row'>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>About us</h2>
<ul>
<li><a href="/info/about">About</a></li>
<li><a href="http://blog.opencorporates.com">Blog</a></li>
<li><a href="/info/team/">Team</a></li>
<li><a href="/info/governance">Governance</a></li>
<li><a href="https://jobs.opencorporates.com">Jobs</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Using our data</h2>
<ul>
<li><a href="/info/our-data">Our data</a></li>
<li><a href="/info/our-purpose">Our purpose</a></li>
<li><a href="/legal/licence">Legal/Licence</a></li>
<li><a href="/legal/user_privacy_policy">User/Cookie privacy policy</a></li>
<li><a href="/legal/public_records_privacy_policy">Public records privacy policy</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Help</h2>
<ul>
<li><a href="https://api.opencorporates.com">API Reference</a></li>
<li><a href="/legal/glossary">Glossary</a></li>
<li><a href="http://status.opencorporates.com">Status</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Contact</h2>
<ul>
<li><a href="http://twitter.com/opencorporates">Twitter</a></li>
<li><a href="https://medium.com/@opencorporates">Medium</a></li>
<li><a href="https://eepurl.com/duayVr">Newsletter</a></li>
<li><a href="/info/contact-us/">Problems with our data?</a></li>
<li><a href="/legal/temporary_redaction">Temporary redaction</a></li>
</ul>
</div>
<div class='oc-footer__column'>
<h2 class='oc-footer__heading'>Impact</h2>
<ul>
<li><a href="http://blog.opencorporates.com/2015/05/26/opencorporates-impact-report-2014/">Impact</a></li>
<li><a href="/legal/grants">Grants</a></li>
</ul>
</div>
</div>
</footer>

<div id='login_dialog' style='display:hidden'></div>


</body>
</html>

OpenCorporates Scraper

You might also like

Instagram Scraper

TikTok Scraper

Google Maps Scraper

Tweet Scraper V2 - X Scraper / Twitter Scraper / X.com Scraper

Instagram Profile Scraper (Bio & Posts)

Instagram Profile Scraper

Google Search Results Scraper

LinkedIn Profile Scraper + Email (No Cookies)

Posts Search Scraper for LinkedIn | No Cookies

Instagram Post Scraper

.gitignore

Dockerfile

eslint.config.mjs

package.json

tsconfig.json

.actor/actor.json

.actor/dataset_schema.json

.actor/input_schema.json

.actor/output_schema.json

readme-stuff/how-it-works-opencorporates.png

readme-stuff/how-it-works-opencorporates.svg

readme-stuff/how-it-works-opencorporates@2x.png

readme-stuff/logo.png

readme-stuff/logo.svg

readme-stuff/logo@2x.png

src/main.ts

test/parser.test.ts

src/types/inputs.ts

src/lib/auth.ts

src/lib/concurrency.ts

src/lib/failureAlertWebhook.ts

src/lib/parser.ts

src/lib/recordStore.ts

src/lib/residentialFallback.ts

src/lib/residentialProbe.ts

src/lib/runTelemetry.ts

src/lib/shardHints.ts

src/lib/telegram.ts

test/fixtures/auth_gb.html

test/fixtures/auth_us_ca.html

test/fixtures/es_80331051.html

test/fixtures/gb_05957738.html

test/fixtures/nl_17087985.html

test/fixtures/us_ca_C0806592.html

test/fixtures/us_de_2138865.html