Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to PredictLeads

Scalekit connector
Open markdown

The PredictLeads connector lets your AI agent act in each user's PredictLeads account. Each user connects their own PredictLeads API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 35 tools.

Tools
35
What they doRead · write · destructive
33 · 1 · 133 read1 write1 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the PredictLeads connection

    In AgentKit > Connections, create a PredictLeads connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'predictleads'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize PredictLeads:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'predictleads_discover_companies',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their PredictLeads credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • predictleads_discover_companiesFind companies by location, employee-count range, NAICS codes, industry or revenue range, most recently updated first.Read-only

    Discover Companies

    Find companies by location, employee-count range, NAICS codes, industry or revenue range, most recently updated first. Returns a page of company records (id, domain, name, description, location); meta.count holds an estimated total when page is sent. Use this to build a company list from filters. Use predictleads_get_company when you know the domain, and predictleads_discover_extended_companies for the same search with headcount and industry data.

    Inputs

    industrystring
    Only return companies that work in this industry. Example: Retail.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    locationstring
    Only return companies in this country name or state name/abbreviation. Example: United States.
    naics_codesstring
    Comma-separated list of NAICS industry codes for companies, with no spaces. Use 2- to 6-digit NAICS codes from census.gov/naics. Example: 5112,541511.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
    revenue_range_highinteger
    Only return companies with revenue equal to or lower than this amount. Example: 100000000.
    revenue_range_lowinteger
    Only return companies with revenue equal to or higher than this amount. Example: 1000000.
    sizesstring
    Comma-separated list of employee-count ranges for companies, with no spaces. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Example: 51-200,201-500.
  • predictleads_discover_companies_by_technologyFind companies that use one technology, by technology ID or name, newest detections first, optionally filtered by company location, size or NAICS codes.Read-only

    Discover Companies by Technology

    Find companies that use one technology, by technology ID or name, newest detections first, optionally filtered by company location, size or NAICS codes. Returns technology detections with first and last seen dates and score, the companies using it in included, and an estimated total in meta.count when page is sent. Use this for technology-based prospect lists. Use predictleads_list_company_technology_detections for one company's stack. If the technology name is ambiguous, get its ID first with predictleads_list_technologies.

    Inputs

    technology_id_or_fuzzy_namestringrequired
    Technology to match, as its PredictLeads technology ID (a UUID) or its name, matched fuzzily. Use the ID from predictleads_list_technologies for multi-word or ambiguous names. Example: hubspot.
    company_locationstring
    Only return companies in this country name or state name/abbreviation. Example: United States.
    company_naics_codesstring
    Comma-separated list of NAICS industry codes for companies, with no spaces. Use 2- to 6-digit NAICS codes from census.gov/naics. Example: 5112,541511.
    company_sizesstring
    Comma-separated list of employee-count ranges for companies, with no spaces. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Example: 51-200,201-500.
    first_seen_at_fromstring
    Only return technology detections first seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    first_seen_at_untilstring
    Only return technology detections first seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    last_seen_at_fromstring
    Only return technology detections last seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    last_seen_at_untilstring
    Only return technology detections last seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
  • predictleads_discover_extended_companiesFind companies by location, employee-count range, NAICS codes, industry or revenue range, returning extended profiles, most recently updated first.Read-only

    Discover Extended Companies

    Find companies by location, employee-count range, NAICS codes, industry or revenue range, returning extended profiles, most recently updated first. Returns a page of extended company records with employee range, industry, company type, headquarters and funding data. Use this when the list needs firmographics. Use predictleads_discover_companies for the lighter company records.

    Inputs

    industrystring
    Only return companies that work in this industry. Example: Retail.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    locationstring
    Only return companies in this country name or state name/abbreviation. Example: United States.
    naics_codesstring
    Comma-separated list of NAICS industry codes for companies, with no spaces. Use 2- to 6-digit NAICS codes from census.gov/naics. Example: 5112,541511.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
    revenue_range_highinteger
    Only return companies with revenue equal to or lower than this amount. Example: 100000000.
    revenue_range_lowinteger
    Only return companies with revenue equal to or higher than this amount. Example: 1000000.
    sizesstring
    Comma-separated list of employee-count ranges for companies, with no spaces. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Example: 51-200,201-500.
  • predictleads_discover_financing_eventsSearch financing events (funding rounds) across all companies, optionally filtered by normalized round type, company location, size, NAICS codes or first seen date, most recently updated first.Read-only

    Discover Financing Events

    Search financing events (funding rounds) across all companies, optionally filtered by normalized round type, company location, size, NAICS codes or first seen date, most recently updated first. Returns financing events with dates, financing type, amount and source URLs, with the funded companies and investors in included. Use this to find recently funded companies. Use predictleads_list_company_financing_events for one company's rounds.

    Inputs

    company_locationstring
    Only return financing events of companies in this country name or state name/abbreviation. Example: United States.
    company_naics_codesstring
    Comma-separated list of NAICS industry codes for companies, with no spaces. Use 2- to 6-digit NAICS codes from census.gov/naics. Example: 5112,541511.
    company_sizesstring
    Comma-separated list of employee-count ranges for companies, with no spaces. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Example: 51-200,201-500.
    financing_types_normalizedstring
    Comma-separated list of normalized financing types, with no spaces. Values follow the pattern <stage>, <stage>_plus, <stage>_plus_plus, pre_<stage>, a numbered stage and a _bridge suffix, for stages angel, seed and series_a to series_j. Examples of valid values: angel, pre_seed, seed, seed_plus, series_a, series_a1, series_b, series_c_plus, seed_bridge, series_a_bridge. Example: seed,series_a.
    first_seen_at_fromstring
    Only return financing events first seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    first_seen_at_untilstring
    Only return financing events first seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
  • predictleads_discover_github_repositoriesList GitHub repositories of all companies, newest first, optionally filtered by first seen date.Read-only

    Discover GitHub Repositories

    List GitHub repositories of all companies, newest first, optionally filtered by first seen date. Returns repositories with URL, description and first seen date, with the owning companies in included. Use this to find companies that recently published repositories. Use predictleads_list_company_github_repositories for one company.

    Inputs

    first_seen_at_fromstring
    Only return GitHub repositories first seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    first_seen_at_untilstring
    Only return GitHub repositories first seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
  • predictleads_discover_job_openingsSearch job openings across all companies by O*NET occupation code, title words, seniority, location, active status or found date.Read-only

    Discover Job Openings

    Search job openings across all companies by O*NET occupation code, title words, seniority, location, active status or found date. Only openings found in the last year are returned. Returns job openings with title, description, URL, categories, seniority, salary and location, the hiring companies in included, and an estimated total in meta.count when page is sent. Use this to find companies hiring for a role. Use predictleads_list_company_job_openings for one company's openings.

    Inputs

    active_onlyboolean
    Set to true to return only open job openings: not closed, last seen in the past 5 days and found within the last year. Example: true.
    found_at_fromstring
    Only return job openings found after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    locationstring
    Only return job openings in this country name or state name/abbreviation. Example: United States.
    onet_codesstring
    Comma-separated list of O*NET occupation codes, with no spaces. Find codes at onetonline.org/find/all, for example 41-4011.00 for technical sales representatives. Example: 41-4011.00,11-2021.00.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
    senioritystring
    Only return job openings with this seniority. One of: not_set, founder, c_level, partner, president, vice_president, head, director, manager, mid_senior, junior. Example: director.one of not_setfounderc_levelpartnerpresidentvice_presidentheaddirectormanagermid_seniorjunior
    titlestring
    Only return job openings whose titles contain all of these words. Example: product manager.
  • predictleads_discover_news_eventsSearch news events across all companies, newest first, optionally filtered by category, company location or company size.Read-only

    Discover News Events

    Search news events across all companies, newest first, optionally filtered by category, company location or company size. Returns news events with category, summary, headline, found date and event details, with the companies involved in included. Use this to find companies with a given kind of event, such as new funding or new hires. Use predictleads_list_company_news_events for one company's events.

    Inputs

    categoriesstring
    Comma-separated list of news event categories, with no spaces. Valid values: acquires, merges_with, sells_assets_to, loses_client, signs_new_client, declares_bankruptcy, files_suit_against, has_issues_with, closes_offices_in, decreases_headcount_by, attends_event, expands_facilities, expands_offices_in, expands_offices_to, increases_headcount_by, opens_new_location, goes_public, has_earnings, has_revenue, has_valuation, invests_into, invests_into_assets, receives_financing, hires, leaves, promotes, retires_from, integrates_with, is_developing, launches, ends_partnership_with, partners_with, receives_award, recognized_as, identified_as_competitor_of, spins_off_company, spins_off_division. Example: receives_financing,launches.
    company_locationstring
    Only return events about companies in this country name or state name/abbreviation. Example: United States.
    company_sizesstring
    Comma-separated list of employee-count ranges for companies, with no spaces. Valid values: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. Example: 51-200,201-500.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.
  • predictleads_discover_portfolio_companiesList portfolio companies found on the portfolio pages of VCs, accelerators and incubators, as investor connections, newest first.Read-only

    Discover Portfolio Companies

    List portfolio companies found on the portfolio pages of VCs, accelerators and incubators, as investor connections, newest first. Returns connections with category investor, source URL, context and first/last seen dates, with the investor and the portfolio company in included. Use this to find newly listed portfolio companies across investors. Use predictleads_list_company_connections for one company's investors and partners.

    Inputs

    first_seen_at_fromstring
    Only return connections first seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    first_seen_at_untilstring
    Only return connections first seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    last_seen_at_fromstring
    Only return connections last seen after this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    last_seen_at_untilstring
    Only return connections last seen before this date (ISO 8601 date). Format: YYYY-MM-DD. Example: 2024-09-25.
    limitinteger
    Number of results per page. PredictLeads defaults to 30 and allows at most 1000. Example: 50.
    pageinteger
    Page number to return, starting at 1. When you send page, the response also includes the total result count in meta.count; PredictLeads leaves the count out when page is not sent. Example: 2.