orangeslice 2.0.0 → 2.0.1

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export { runApifyActor } from "./apify";
 export type { RunActorParams, RunActorResult, DatasetListParams } from "./apify";
 export { googleMapsScrape } from "./googleMaps";
 export type { GoogleMapsScrapeParams } from "./googleMaps";
+export { executePredictLeads, predictLeads, PREDICT_LEADS_OPERATION_IDS } from "./predictLeads";
+export type { PredictLeadsMethodName, PredictLeadsParams, PredictLeadsServiceMap } from "./predictLeads";
 export { personLinkedinEnrich, personLinkedinFindUrl, personContactGet, companyLinkedinEnrich, companyLinkedinFindUrl, companyGetEmployeesFromLinkedin, geoParseAddress, builtWithLookupDomain, builtWithRelationships, builtWithSearchByTech } from "./expansion";
 export type { PersonLinkedinFindUrlParams, CompanyLinkedinFindUrlParams, PersonContactGetParams, PersonContactGetResult, CompanyGetEmployeesFromLinkedinParams, CompanyGetEmployeesFromLinkedinResult, CompanyEmployeeFromB2B } from "./expansion";
 import { runApifyActor } from "./apify";
@@ -70,5 +72,6 @@ export declare const services: {
         relationships: typeof builtWithRelationships;
         searchByTech: typeof builtWithSearchByTech;
     };
+    predictLeads: Readonly<import("./predictLeads").PredictLeadsServiceMap>;
 };
 export default services;

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.services = exports.builtWithSearchByTech = exports.builtWithRelationships = exports.builtWithLookupDomain = exports.geoParseAddress = exports.companyGetEmployeesFromLinkedin = exports.companyLinkedinFindUrl = exports.companyLinkedinEnrich = exports.personContactGet = exports.personLinkedinFindUrl = exports.personLinkedinEnrich = exports.googleMapsScrape = exports.runApifyActor = exports.browserExecute = exports.scrapeWebsite = exports.generateObject = exports.webBatchSearch = exports.webSearch = exports.linkedinSearch = exports.configure = void 0;
+exports.services = exports.builtWithSearchByTech = exports.builtWithRelationships = exports.builtWithLookupDomain = exports.geoParseAddress = exports.companyGetEmployeesFromLinkedin = exports.companyLinkedinFindUrl = exports.companyLinkedinEnrich = exports.personContactGet = exports.personLinkedinFindUrl = exports.personLinkedinEnrich = exports.PREDICT_LEADS_OPERATION_IDS = exports.predictLeads = exports.executePredictLeads = exports.googleMapsScrape = exports.runApifyActor = exports.browserExecute = exports.scrapeWebsite = exports.generateObject = exports.webBatchSearch = exports.webSearch = exports.linkedinSearch = exports.configure = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return api_1.configure; } });
 var b2b_1 = require("./b2b");
@@ -18,6 +18,10 @@ var apify_1 = require("./apify");
 Object.defineProperty(exports, "runApifyActor", { enumerable: true, get: function () { return apify_1.runApifyActor; } });
 var googleMaps_1 = require("./googleMaps");
 Object.defineProperty(exports, "googleMapsScrape", { enumerable: true, get: function () { return googleMaps_1.googleMapsScrape; } });
+var predictLeads_1 = require("./predictLeads");
+Object.defineProperty(exports, "executePredictLeads", { enumerable: true, get: function () { return predictLeads_1.executePredictLeads; } });
+Object.defineProperty(exports, "predictLeads", { enumerable: true, get: function () { return predictLeads_1.predictLeads; } });
+Object.defineProperty(exports, "PREDICT_LEADS_OPERATION_IDS", { enumerable: true, get: function () { return predictLeads_1.PREDICT_LEADS_OPERATION_IDS; } });
 var expansion_1 = require("./expansion");
 Object.defineProperty(exports, "personLinkedinEnrich", { enumerable: true, get: function () { return expansion_1.personLinkedinEnrich; } });
 Object.defineProperty(exports, "personLinkedinFindUrl", { enumerable: true, get: function () { return expansion_1.personLinkedinFindUrl; } });
@@ -36,6 +40,7 @@ const expansion_2 = require("./expansion");
 const firecrawl_2 = require("./firecrawl");
 const generateObject_2 = require("./generateObject");
 const googleMaps_2 = require("./googleMaps");
+const predictLeads_2 = require("./predictLeads");
 const serp_2 = require("./serp");
 exports.services = {
     company: {
@@ -82,6 +87,7 @@ exports.services = {
         lookupDomain: expansion_2.builtWithLookupDomain,
         relationships: expansion_2.builtWithRelationships,
         searchByTech: expansion_2.builtWithSearchByTech
-    }
+    },
+    predictLeads: predictLeads_2.predictLeads
 };
 exports.default = exports.services;

package/dist/predictLeads.d.ts

@@ -0,0 +1,36 @@
+export declare const PREDICT_LEADS_OPERATION_IDS: {
+    readonly apiSubscription: "api_subscription";
+    readonly companies: "companies";
+    readonly company: "company";
+    readonly companyConnections: "company_connections";
+    readonly companyFinancingEvents: "company_financing_events";
+    readonly companyGithubRepositories: "company_github_repositories";
+    readonly companyJobOpenings: "company_job_openings";
+    readonly companyNewsEvents: "company_news_events";
+    readonly companyProducts: "company_products";
+    readonly companySimilarCompanies: "company_similar_companies";
+    readonly companyTechnologyDetections: "company_technology_detections";
+    readonly companyWebsiteEvolution: "company_website_evolution";
+    readonly discoverConnectionInvestors: "discover_connection_investors";
+    readonly discoverJobOpenings: "discover_job_openings";
+    readonly discoverProducts: "discover_products";
+    readonly discoverTechnologyTechnologyDetections: "discover_technology_technology_detections";
+    readonly financingEvents: "financing_events";
+    readonly followCompany: "follow_company";
+    readonly followedCompanies: "followed_companies";
+    readonly jobOpening: "job_opening";
+    readonly newsEvent: "news_event";
+    readonly newsEvents: "news_events";
+    readonly product: "product";
+    readonly startupPlatformPosts: "startup_platform_posts";
+    readonly technologies: "technologies";
+    readonly technology: "technology";
+    readonly unfollowCompany: "unfollow_company";
+};
+export type PredictLeadsMethodName = keyof typeof PREDICT_LEADS_OPERATION_IDS;
+export type PredictLeadsParams = Record<string, unknown>;
+export type PredictLeadsServiceMap = {
+    [K in PredictLeadsMethodName]: (params?: PredictLeadsParams) => Promise<unknown>;
+};
+export declare function executePredictLeads(operationId: (typeof PREDICT_LEADS_OPERATION_IDS)[PredictLeadsMethodName], params?: PredictLeadsParams): Promise<unknown>;
+export declare const predictLeads: Readonly<PredictLeadsServiceMap>;

package/dist/predictLeads.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.predictLeads = exports.PREDICT_LEADS_OPERATION_IDS = void 0;
+exports.executePredictLeads = executePredictLeads;
+const api_1 = require("./api");
+exports.PREDICT_LEADS_OPERATION_IDS = {
+    apiSubscription: "api_subscription",
+    companies: "companies",
+    company: "company",
+    companyConnections: "company_connections",
+    companyFinancingEvents: "company_financing_events",
+    companyGithubRepositories: "company_github_repositories",
+    companyJobOpenings: "company_job_openings",
+    companyNewsEvents: "company_news_events",
+    companyProducts: "company_products",
+    companySimilarCompanies: "company_similar_companies",
+    companyTechnologyDetections: "company_technology_detections",
+    companyWebsiteEvolution: "company_website_evolution",
+    discoverConnectionInvestors: "discover_connection_investors",
+    discoverJobOpenings: "discover_job_openings",
+    discoverProducts: "discover_products",
+    discoverTechnologyTechnologyDetections: "discover_technology_technology_detections",
+    financingEvents: "financing_events",
+    followCompany: "follow_company",
+    followedCompanies: "followed_companies",
+    jobOpening: "job_opening",
+    newsEvent: "news_event",
+    newsEvents: "news_events",
+    product: "product",
+    startupPlatformPosts: "startup_platform_posts",
+    technologies: "technologies",
+    technology: "technology",
+    unfollowCompany: "unfollow_company"
+};
+async function executePredictLeads(operationId, params) {
+    return (0, api_1.post)("/execute/predictleads", {
+        operationId,
+        params: params ?? {}
+    });
+}
+exports.predictLeads = Object.freeze(Object.fromEntries(Object.entries(exports.PREDICT_LEADS_OPERATION_IDS).map(([methodName, operationId]) => [
+    methodName,
+    async (params) => executePredictLeads(operationId, params)
+])));

package/docs/prospecting/index.md

@@ -83,12 +83,28 @@ When using qualification columns, think Circle & Star:
 | Source                   | Use When                                                    | Limitations                                              |
 | ------------------------ | ----------------------------------------------------------- | -------------------------------------------------------- |
 | **Web Search (Default)** | **Everything else** — keywords, niche, fuzzy, specific      | Requires verification columns for false positives.       |
+| **PredictLeads**         | Company intelligence, buying signals, and structured company events at scale | Coverage varies by company/market; use web search for very niche long-tail discovery. |
 | **Niche Directory Scrape** | Well-defined categories with existing lists (see below)   | Requires finding the right directory first.              |
 | **LinkedIn B2B DB**      | **Indexed lookups ONLY:** company by domain/slug/ID, employees at known company, basic 2-table funding. | **3s hard max. No keyword search, no LATERAL, no 3+ table joins.** Everything else = web search. |
 | **Google Maps**          | Local/SMB, physical locations, restaurants, retail          | Limited to businesses with physical presence.            |
 | **NPI Database**         | Healthcare providers                                        | Healthcare only. Free.                                   |
 | **Apify Actors**         | Platform-specific scraping (Instagram, TikTok, job boards)  | Per-platform setup. May break with platform changes.     |
 
+### PredictLeads: When It Is Better Than Everything Else
+
+Use PredictLeads first when the user needs **high-quality structured company data** and not just URLs.
+
+PredictLeads is usually the best choice for:
+- Tracking **company signals over time** (news, financing, hiring, tech detections, product changes, website evolution)
+- Pulling **normalized lists** (job openings, technologies, investors/connections, similar companies) without custom scraping
+- Building qualification columns where consistency matters more than recall
+- Workflows that need stable structured fields instead of parsing search snippets
+
+Prefer other sources when:
+- You need **brand-new niche discovery** with fuzzy intent matching -> use `web.search`
+- You need local storefront/SMB discovery -> use Google Maps
+- You need fast indexed LinkedIn lookups by known IDs/domain/company -> use LinkedIn B2B DB
+
 ### Niche Directory Scraping — For Well-Defined Categories
 
 When users ask for companies in a **specific, well-defined niche** (e.g., "fast food chains", "Fortune 500 companies", "Y Combinator startups"), the best approach is often to **find and scrape a curated directory or list**.