Add Ploid to your AI agent

Preferred connection diagnostic for verifying which Ploid workspace and API key are connected. Returns workspace ACU usage, the calling key's ID and budget, and the number of active keys. No charge is documented.

Return a dataset's lifecycle status, configured columns, row-processing progress, and rows URL. No read charge is documented.

Fetch public LinkedIn company details by URL, universal name, or search term; provide at least one of those locators. This read can consume ACU, but Ploid does not publish a fixed amount.

Fetch one public LinkedIn profile by full URL, vanity slug, or @handle. Warning: this read can consume ACU, but Ploid does not publish a fixed per-call cost; workspace balance and API-key budget checks apply.

Return one monitor and its current configuration. No read charge is documented. Ploid requires a monitor permission but does not document its name.

Return one monitor run by monitor and run ID, including lifecycle state, usage, error, and webhook delivery outcome. No read charge is documented. Ploid requires monitor permission but does not publicly name its scope.

Get an evidence-backed reviewed person record or start a durable research run. The first successful organization-wide profile access costs exactly 25 ACU, including a first access served from cache; rereads are free for 90 days, and failed, unsure, or not-found runs are free. A 202 response is only a run handle: poll it with Get Person Run rather than repeating this POST. Stale cached results can queue a background refresh.

Get the current state or terminal result of a deep-person research run. Polling has no separate charge; the originating successful profile may cost 25 ACU.

Return a preview People Set's status, progress, and searches, newest first. No read charge is documented. This preview API is absent from Ploid's OpenAPI document and its response contract may change before general availability.

Return recruiters and role counts for up to 10 companies. Ploid bills unique non-placeholder companies for returned matches, but the exact ACU amount is not published.

Return one integer-cursor page of dataset rows in seed order, including rows available before asynchronous processing finishes. No read charge is documented.

Return one provider page of posts for a LinkedIn company. The fixed cost is unknown. Use company, company_id, or company_universal_name to select a company when needed. Optional posted_limit and scrape_posted_limit opaque provider selectors are available for values documented by Ploid or previously known to work. Supply page and pagination_token manually because the response location of the next token is undocumented.

Return up to 20 recent posts for one public LinkedIn profile identified by profile URL, vanity slug, or @handle; provide identifier or its url alias. This read can consume ACU, but Ploid does not publish a fixed cost.

Return one provider page of comments made by a LinkedIn profile. This read can consume ACU, but Ploid does not publish a fixed amount. Use profile or profile_id to select a profile when needed. The optional posted_limit opaque provider selector is available for a value documented by Ploid or previously known to work. Supply page and pagination_token manually because the response location of the next token is undocumented.

Return one cursor-controlled page of emitted monitor items, optionally limited to one run. No read charge is documented. Ploid requires a monitor permission but does not document its name.

Return one cursor-controlled page of a monitor's runs, newest first. No read charge is documented. Ploid requires a monitor permission but does not document its name.

Return one cursor-controlled page of monitors, newest first. No read charge is documented. Ploid requires monitor permission but does not publicly name the required scope.

Return one caller-controlled page of admitted, criterion-verified people while or after a preview People Set runs. Reading does not have a documented charge; billing belongs to the originating search and settles at 1 ACU per 10 admitted people, rounded up. Follow data.next_cursor for the next page; the preview API may add further response metadata before general availability.

List the workspace's recent People Sets. This API is in preview: Ploid documents the response as data.sets and does not document item fields or pagination controls. No read charge is documented.

Resolve a named person plus at least one identity clue to a permanent Ploid person ID. A found match costs 2 ACU; no match is free. Reusing an idempotency key is safe only for an identical authenticated retry.

Queue a persistent monitor run now. It costs 1 ACU per target fetched plus 1 ACU per emitted item, saves emitted items, and may deliver events to the monitor's configured webhook. The run continues after the 202 response. Poll the returned run instead of repeating this POST. Supply an Idempotency-Key and reuse it with identical input for an uncertain retry. The required monitor permission name is undocumented.

Search Ploid's GitHub account index by profile, repository, language, and activity filters. Provide at least one account search criterion. Each completed search costs 1 ACU; include_profiles adds 1 ACU per live profile found. Failed searches are free.

Search GitHub accounts, link unambiguous accounts to indexed LinkedIn people, and enforce optional LinkedIn filters as hard requirements. Provide at least one GitHub search criterion. Costs 1 ACU per completed search plus 1 ACU per returned person; failed searches are free. Pages advance over GitHub accounts scanned, so returned results can be fewer than the page limit; continue with data.next_offset.

Return one cursor-controlled page of public LinkedIn people matching structured keyword, location, title, current-company, and school filters. This search can consume ACU or API-key budget, but Ploid does not publish a fixed cost.

Search for up to 150 people and return typed results inline. Pricing varies by search mode and returned results. Use Create People Set for durable background searches.

Search the indexed people directory for up to 10 unverified identity candidates. Costs exactly 1 ACU for every completed search, including zero matches; failures are free. Does not research or enrich profiles.

Fetch and evaluate a monitor's current targets without saving a run, items, seen-ledger entries, or snapshots; sending a webhook; or changing its schedule. Each call costs exactly 1 ACU per target fetched, including targets that yield no relevant items. Ploid does not document the required monitor permission name.

Immediately send one signed monitor.webhook.test event to the monitor's configured external webhook. This causes external network delivery as soon as the action runs. Ploid makes one delivery attempt with no retries, and this operation costs no ACU. Supply an Idempotency-Key and reuse it with identical input after an uncertain result to avoid duplicate delivery. Ploid requires a monitor permission but does not document its name.

REAL ACCOUNT MUTATION: replace the signed-in user's WorkOS-linked Ploid profile fields. Every field is required; null clears a profile URL. No charge is documented. NEVER TEST OR CALL THIS ACTION against a real account; use it only with an explicitly authorized disposable account.

Update, pause, or resume a monitor by providing at least one field to change. This mutates its durable configuration; query or plan changes start a new baseline run and may lead to later scheduled work. No fixed update charge is documented, but baseline work can consume ACU or API-key budget. Webhook configuration is intentionally unavailable in this action. Ploid does not document the monitor permission name.