Public Integration Ecosystem Signal Agent

Turn a public integrations, apps, marketplace, partners, connectors, or product ecosystem page into a compact ecosystem-readiness snapshot for AI agents, partnership teams, product marketers, sales researchers, and vendor evaluation workflows.

The Actor fetches only the supplied public page, parses visible HTML, and reports whether the product appears to have a rich integration ecosystem, clear category coverage, developer/API paths, and partner-program paths.

What It Detects

• Named integration and app hints such as Slack, Salesforce, HubSpot, Shopify, Stripe, Zapier, GitHub, and Google Sheets.
• Category coverage hints such as CRM, communication, automation, analytics, support, payments, ecommerce, developer tools, identity, storage, and project management.
• API, docs, SDK, webhook, developer, OpenAPI, or Swagger links.
• Partner, reseller, affiliate, agency, solution-partner, or technology-partner links.
• Marketplace signals such as app directory pages, category navigation, search/filter inputs, install/connect CTAs, and coverage-count claims.
• Optional focus-tool matches.
• Risk labels, missing fields, diagnostics, evidence URLs, and a stable ecosystemHash.

Safety Boundary

• Public HTTP/HTTPS pages only.
• No browser rendering, login, cookies, form submission, private APIs, or whole-site crawling.
• Rejects credentials, path parameters, query strings, fragments, localhost, .local, private/non-global IPs, sensitive account paths, and token-like path segments.
• HTML/text response size is capped at 3 MB, including gzip decompression.
• Discovered links are sanitized and reported as evidence only; they are not fetched.

Pricing Intent

Pricing model: PAY_PER_EVENT

• apify-actor-start: minimum run-start event.
• useful-integration-ecosystem-result: charged only for useful public integration ecosystem snapshots that are new or changed.

Error, unsupported URL, unchanged, focus-miss, low-evidence, and low-completeness records should not charge the useful event. Do not configure apify-default-dataset-item.

Example Input

{
  "urls": ["https://example.com/integrations"],
  "focusTools": ["Slack", "Salesforce", "Shopify"],
  "requestTimeoutSecs": 20
}

Example Output Shape

{
  "status": "ok",
  "normalizedUrl": "https://example.com/integrations",
  "title": "Acme App Marketplace",
  "ecosystemType": "marketplace",
  "integrationNameHints": [{"name": "Slack", "category": "communication"}],
  "categoryHints": [{"category": "crm"}, {"category": "payments"}],
  "apiOrDocsLinks": [{"text": "API documentation", "url": "https://example.com/docs/api"}],
  "partnerProgramLinks": [{"text": "Partner program", "url": "https://example.com/partners"}],
  "marketplaceSignals": [{"type": "integrationCoverage", "text": "8 named integrations"}],
  "matchedFocusTools": ["Salesforce", "Slack"],
  "ecosystemScore": 0.9,
  "changeStatus": "new",
  "billableEventName": "useful-integration-ecosystem-result"
}