# Public Vendor Registry Intelligence (`taroyamada/public-vendor-registry-intelligence`) Actor Extract procurement-ready B2B fields from public vendor registry, supplier portal, and supplier registration pages using direct-source URLs only, with PPE charged events and no-charge diagnostics. - **URL**: https://apify.com/taroyamada/public-vendor-registry-intelligence.md - **Developed by:** [åĪŠéƒŽ åąąį”°](https://apify.com/taroyamada) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Public Vendor Registry Intelligence Extract procurement-ready B2B fields from public vendor registry, supplier portal, supplier onboarding, and registration pages. V1 is direct-source only: it uses URLs or domains you provide plus same-domain vendor/procurement links found on those pages. It does not use search engines, private portals, authentication, or paid supplier data. ### What It Returns - Organization and registry names - Registry URL, website, portal type, and registration status - Supplier categories, required documents, eligibility language, contacts, and deadlines - Confidence, status, chargedEvent, sourceUrls, and errors on every dataset row ### PPE Events - `vendor_profile_enriched`: useful enriched vendor registry profile - `vendor_partial`: useful partial registry evidence - `invalid`, `blocked`, `not_found`, `not_vendor_registry`, and `error`: no-charge diagnostic rows ### Inputs Use `urls` for exact registration or supplier portal pages, or `domains` when you want the actor to inspect a public buyer domain for same-domain vendor registration links. Keep `maxLinkedPages` low for the cheapest proof path. ### Positioning Use this after Procurement Intel identifies a buyer, agency, or opportunity and you need onboarding evidence: supplier registration pages, required documents, eligibility signals, and public contact paths. # Actor input Schema ## `urls` (type: `array`): Public vendor registration, supplier portal, procurement, bid/vendor registry, or supplier onboarding URLs to fetch directly. No search engine discovery is used. ## `domains` (type: `array`): Optional bare domains from public agencies, enterprises, or buyer lists. Domains are normalized to https://domain/ and inspected for same-domain vendor registration links only. ## `buyerType` (type: `string`): Optional buyer context used only for local classification hints. Examples: government, healthcare, university, enterprise, utility, construction. ## `region` (type: `string`): Optional region, state, country, or sourcing market to match against page text. ## `maxLinkedPages` (type: `integer`): When a supplied page links to same-domain vendor registration, supplier portal, procurement, or bid pages, fetch up to this many extra direct-source pages as evidence. ## `maxResults` (type: `integer`): Maximum normalized direct sources to process and emit. ## `dryRun` (type: `boolean`): Validate input and write local output without sending dataset rows or charging custom PPE events. ## Actor input object example ```json { "urls": [ "https://www.nyc.gov/site/mocs/systems/passport.page", "https://www.ungm.org/Public/Pages/RegistrationProcess" ], "domains": [ "nyc.gov", "ungm.org" ], "buyerType": "", "region": "", "maxLinkedPages": 2, "maxResults": 25, "dryRun": false } ```` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.nyc.gov/site/mocs/systems/passport.page", "https://www.ungm.org/Public/Pages/RegistrationProcess" ], "domains": [ "nyc.gov", "ungm.org" ] }; // Run the Actor and wait for it to finish const run = await client.actor("taroyamada/public-vendor-registry-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`ðŸ’ū Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": [ "https://www.nyc.gov/site/mocs/systems/passport.page", "https://www.ungm.org/Public/Pages/RegistrationProcess", ], "domains": [ "nyc.gov", "ungm.org", ], } # Run the Actor and wait for it to finish run = client.actor("taroyamada/public-vendor-registry-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("ðŸ’ū Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.nyc.gov/site/mocs/systems/passport.page", "https://www.ungm.org/Public/Pages/RegistrationProcess" ], "domains": [ "nyc.gov", "ungm.org" ] }' | apify call taroyamada/public-vendor-registry-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/public-vendor-registry-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Public Vendor Registry Intelligence", "description": "Extract procurement-ready B2B fields from public vendor registry, supplier portal, and supplier registration pages using direct-source URLs only, with PPE charged events and no-charge diagnostics.", "version": "0.1", "x-build-id": "XYOVybBJKPTE9NQcb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~public-vendor-registry-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-public-vendor-registry-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/taroyamada~public-vendor-registry-intelligence/runs": { "post": { "operationId": "runs-sync-taroyamada-public-vendor-registry-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/taroyamada~public-vendor-registry-intelligence/run-sync": { "post": { "operationId": "run-sync-taroyamada-public-vendor-registry-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "Vendor Registry URLs", "maxItems": 100, "type": "array", "description": "Public vendor registration, supplier portal, procurement, bid/vendor registry, or supplier onboarding URLs to fetch directly. No search engine discovery is used.", "items": { "type": "string" }, "default": [] }, "domains": { "title": "Procurement Domains", "maxItems": 100, "type": "array", "description": "Optional bare domains from public agencies, enterprises, or buyer lists. Domains are normalized to https://domain/ and inspected for same-domain vendor registration links only.", "items": { "type": "string" }, "default": [] }, "buyerType": { "title": "Buyer Type Hint", "type": "string", "description": "Optional buyer context used only for local classification hints. Examples: government, healthcare, university, enterprise, utility, construction.", "default": "" }, "region": { "title": "Region Hint", "type": "string", "description": "Optional region, state, country, or sourcing market to match against page text.", "default": "" }, "maxLinkedPages": { "title": "Max Linked Registration Pages", "minimum": 0, "maximum": 5, "type": "integer", "description": "When a supplied page links to same-domain vendor registration, supplier portal, procurement, or bid pages, fetch up to this many extra direct-source pages as evidence.", "default": 2 }, "maxResults": { "title": "Max Registry Profiles", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum normalized direct sources to process and emit.", "default": 25 }, "dryRun": { "title": "Dry Run", "type": "boolean", "description": "Validate input and write local output without sending dataset rows or charging custom PPE events.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```