{
  "openapi": "3.0.1",
  "info": {
    "title": "Lead Generation: B2B Leads, Verified Emails & Buying Signals",
    "description": "Sales leads, B2B leads finder and email finder: describe your buyer in one sentence, get decision makers with verified work emails, phones and buying signals. Live data from 30+ sources, each lead scored by AI against your ideal customer. Pay per result.",
    "version": "0.1",
    "x-build-id": "Gsb8JUzAcYlmKinJ4"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/openclawai~b2b-leads-finder/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-openclawai-b2b-leads-finder",
        "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/openclawai~b2b-leads-finder/runs": {
      "post": {
        "operationId": "runs-sync-openclawai-b2b-leads-finder",
        "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/openclawai~b2b-leads-finder/run-sync": {
      "post": {
        "operationId": "run-sync-openclawai-b2b-leads-finder",
        "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": {
          "mode": {
            "title": "How do you want to find leads?",
            "enum": [
              "describe",
              "icp_search",
              "companies",
              "lookalike",
              "enrich_list",
              "local_business"
            ],
            "type": "string",
            "description": "Describe (default) = one sentence in the next field: the easiest way, and the only field an AI agent needs. Filters = job titles, industries, technologies. Target companies = your account list (websites, names or LinkedIn company URLs). Lookalikes = companies like your best customers. Your own list = paste people or companies (or a dataset ID), pick columns and AI columns, get every row back filled. Local businesses = businesses from maps and directories.",
            "default": "describe"
          },
          "prompt": {
            "title": "Describe your ideal customer in one sentence",
            "type": "string",
            "description": "Brief it like a sales researcher: role, company type, size, country, tools they use, roles they are hiring for. Example: 'VP Sales at US fintech companies with 50-500 employees using HubSpot, hiring SDRs'. The run summary shows the search plan built from it. In the other modes this sentence is optional and tells the AI fit score who your ideal customer is."
          },
          "maxLeads": {
            "title": "How many leads",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Leads to deliver. You pay only for delivered leads; the run stops at this number or at the run's maximum cost, whichever comes first. Every lead is looked up live, so expect a few minutes for small runs.",
            "default": 25
          },
          "onlyWithEmail": {
            "title": "Only leads with a verified work email",
            "type": "boolean",
            "description": "On (recommended): every delivered lead has a work email that passed verification during this run and belongs to the lead's current company. Former-employer addresses and unresolved catch-all guesses are dropped, never sold. Off: leads without a verified email are delivered too, at the lead price only (email empty, or marked risky or unverified). In the 'Your own list' mode every row still comes back (see match_status); this setting then keeps unverified addresses out of the email column.",
            "default": true
          },
          "findPhones": {
            "title": "Find mobile or direct phone numbers",
            "type": "boolean",
            "description": "Adds a mobile or direct number when one is found; charged only when found. Off by default: work emails only. Phone numbers are personal data, so use them where you have a lawful basis to call.",
            "default": false
          },
          "scanWebsites": {
            "title": "Buying signals from company websites (free)",
            "type": "boolean",
            "description": "Scan each company's website, careers feed and newsroom: open roles with their posting dates (and which match your roles), funding, new executives, acquisitions, launches and deals with their dates and source links, plus tech stack and ad tracking. Adds an intent score (hot / warm / cold) from events of the last 90 days and a dated 'why now' line. Free.",
            "default": true
          },
          "hiringFor": {
            "title": "Roles they are hiring for (buying signal)",
            "type": "array",
            "description": "Flag companies with open jobs for these roles, e.g. SDR, Account Executive, Data Engineer. Read from public careers pages with each role's posting date: roles posted in the last 90 days count toward intent. When this is empty, Describe mode uses the roles in your sentence ('hiring SDRs').",
            "items": {
              "type": "string"
            }
          },
          "deepSignals": {
            "title": "Deep buying signals (news check, paid)",
            "type": "boolean",
            "description": "For each company you get leads from, also check recent news coverage (funding, new executives, acquisitions, expansion) and, when you list roles above and the company has no public careers feed, a jobs index. Every signal has a date and a source link. Charged once per company, only when it finds a new event from the last 90 days.",
            "default": false
          },
          "aiOpener": {
            "title": "AI-written first line",
            "type": "boolean",
            "description": "A personal opening line for a cold email, written from the lead's own facts and buying signals. Charged only when written.",
            "default": false
          },
          "offer": {
            "title": "What you sell (sharpens scoring and first lines)",
            "type": "string",
            "description": "One or two sentences about your product. Added to your ideal customer for the AI fit score, and used to write first lines."
          },
          "leadsPerCompany": {
            "title": "People per company (buying committee)",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "1 = the single best match per company. Up to 5 = a buying committee: decision maker, champion, technical evaluator and end users, each labeled with a buying role. Applies in every mode.",
            "default": 2
          },
          "companies": {
            "title": "Company websites, names or LinkedIn company URLs",
            "type": "array",
            "description": "One per line: stripe.com · Stripe · https://www.linkedin.com/company/stripe. Websites work best; a name alone can match the wrong company. In the 'Your own list' mode these are enriched as company rows.",
            "items": {
              "type": "string"
            }
          },
          "seedCompanies": {
            "title": "Your best customers (websites)",
            "type": "array",
            "description": "3-50 websites of customers you want more of, one per line.",
            "items": {
              "type": "string"
            }
          },
          "people": {
            "title": "People or companies to enrich",
            "type": "array",
            "description": "A list of rows. People: any of full_name (or first_name + last_name), job_title, linkedin_url, email, company, company_domain. Companies: company_domain (website), company name or company_linkedin_url. We find and verify the work email, check that the person still works there (people who moved are followed to their new company), and add company data, the columns you pick and your AI columns. Your own fields (e.g. a CRM id) come back in input_row. Describe your ideal customer above to get AI fit scores too."
          },
          "datasetId": {
            "title": "…or a dataset ID from another run",
            "type": "string",
            "description": "Enrich the rows of a dataset from another Apify Actor run: people or companies (fields like name, company, website, linkedin_url and email are read automatically)."
          },
          "localQueries": {
            "title": "What businesses?",
            "type": "array",
            "description": "As you would type into Google Maps: dentist, roofing contractor, yoga studio.",
            "items": {
              "type": "string"
            }
          },
          "localLocations": {
            "title": "Where?",
            "type": "array",
            "description": "City + state or country, one per line: Austin, TX · Manchester, UK.",
            "items": {
              "type": "string"
            }
          },
          "localSources": {
            "title": "Directories",
            "type": "array",
            "description": "Pick several to catch businesses one directory misses; duplicates are merged.",
            "items": {
              "type": "string",
              "enum": [
                "google_maps",
                "yelp",
                "bing_maps",
                "tripadvisor",
                "yellow_pages"
              ],
              "enumTitles": [
                "Google Maps",
                "Yelp",
                "Bing Maps",
                "Tripadvisor",
                "Yellow Pages (US)"
              ]
            },
            "default": [
              "google_maps"
            ]
          },
          "localGuessEmails": {
            "title": "Check standard addresses when a site shows none",
            "type": "boolean",
            "description": "When a business's website publishes no email, check whether its standard address (info@, office@, contact@ or hello@) exists at its own domain. Only an address the business's mail server confirms is kept, marked email_source = mail_server. Not used for chain or franchise locations, whose standard address belongs to the head office.",
            "default": true
          },
          "titles": {
            "title": "Job titles",
            "type": "array",
            "description": "One per line, as written on profiles: Head of Revenue Operations, VP Sales, CTO, Founder.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Company industries, e.g. Computer Software, Financial Services.",
            "items": {
              "type": "string"
            }
          },
          "technologies": {
            "title": "Technologies they use",
            "type": "array",
            "description": "Tools the companies use, e.g. HubSpot, Salesforce, Shopify. Also flagged as a buying signal when found on their website.",
            "items": {
              "type": "string"
            }
          },
          "companySizeMin": {
            "title": "Company size: min employees",
            "minimum": 1,
            "type": "integer",
            "description": "Leave empty for any size. Leads at companies known to be smaller are dropped (with a small tolerance)."
          },
          "companySizeMax": {
            "title": "Company size: max employees",
            "minimum": 1,
            "type": "integer",
            "description": "Leave empty for any size. Leads at companies known to be bigger are dropped (with a small tolerance)."
          },
          "country": {
            "title": "Country (2-letter code)",
            "type": "string",
            "description": "ISO code, e.g. US, GB (not UK), DE, FR. Leave empty for worldwide. Overrides the country in your Describe sentence. Location guides the search and the AI fit score; it is not a hard filter on every source."
          },
          "locations": {
            "title": "Cities or regions",
            "type": "array",
            "description": "Spelled out, e.g. 'Greater London, United Kingdom', 'Austin, Texas'.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Skills or topics to narrow the people search, e.g. 'outbound', 'Salesforce admin'. Best effort: not every source supports keyword filters.",
            "items": {
              "type": "string"
            }
          },
          "columns": {
            "title": "Column groups (free)",
            "type": "array",
            "description": "Free column groups, all on by default. Phones and AI first lines stay separate options.",
            "items": {
              "type": "string",
              "enum": [
                "career",
                "company_deep",
                "socials",
                "signals"
              ],
              "enumTitles": [
                "Career: seniority, department, in role since, previous companies and titles, education, connections",
                "Company: employee range, founded, revenue range, funding, headcount growth, keywords, industry codes, logo",
                "Company socials: X (Twitter), Facebook, Instagram, YouTube, TikTok",
                "Signals as columns: new in role, signals in the last 90 days, latest signal date, signal types"
              ]
            },
            "default": [
              "career",
              "company_deep",
              "socials",
              "signals"
            ]
          },
          "aiColumns": {
            "title": "🧠 AI columns (ask anything about each lead)",
            "maxItems": 5,
            "type": "array",
            "description": "Up to 5 questions, answered for every delivered lead from that lead's own facts only (profile, company data, website signals). Each becomes a column ai_<name> plus ai_<name>_confidence (0-1). Types: yes_no (yes or no), score (0-100), choice (one of your choices), text (a short answer, checked against the facts and left empty when they do not support it). Charged per answer given. Example: name 'Sells to developers', question 'Does the company sell to software developers?', type yes_no.",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "title": "Column name",
                  "type": "string",
                  "editor": "textfield",
                  "minLength": 1,
                  "maxLength": 40,
                  "description": "Short name; the column is ai_<name>, e.g. ai_sells_to_developers."
                },
                "question": {
                  "title": "Question",
                  "type": "string",
                  "editor": "textarea",
                  "minLength": 3,
                  "maxLength": 500,
                  "description": "What to ask about each lead, e.g. 'Does the company sell to software developers?'"
                },
                "type": {
                  "title": "Answer type",
                  "type": "string",
                  "editor": "select",
                  "enum": [
                    "yes_no",
                    "score",
                    "choice",
                    "text"
                  ],
                  "enumTitles": [
                    "Yes / no",
                    "Score 0-100",
                    "One of my choices",
                    "Short text"
                  ],
                  "description": "yes_no, score (0-100), choice or text."
                },
                "choices": {
                  "title": "Choices (choice) or levels (score)",
                  "type": "string",
                  "editor": "textfield",
                  "description": "Comma-separated. For choice: 2-12 options, e.g. 'SMB, Mid-market, Enterprise'. For score: optional levels from lowest to highest."
                }
              },
              "required": [
                "name",
                "question",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "minFitScore": {
            "title": "Minimum AI fit score (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Each lead is scored against your ideal customer (role, seniority, company type, size, place): a clear 'good' fit scores about 67, an 'ideal' fit 100, a 'weak' one about 33. Leads below this score are dropped before any contact lookup, so you never pay for them. 60 keeps good and ideal fits; raise it to 75 or more for near-ideal only; 0 keeps everyone.",
            "default": 60
          },
          "aiQualification": {
            "title": "AI fit scoring",
            "type": "boolean",
            "description": "Score each lead and label its buying role (decision maker, champion, technical evaluator, end user). In the 'Your own list' mode it runs only when you describe your ideal customer above.",
            "default": true
          },
          "qualityTier": {
            "title": "Email and phone search depth",
            "enum": [
              "eco",
              "standard",
              "max"
            ],
            "type": "string",
            "description": "How far down our list of 30+ sources each lookup may go. The price per verified email is the same; deeper finds more.",
            "default": "standard"
          },
          "excludeDomains": {
            "title": "Exclude companies (domains)",
            "type": "array",
            "description": "Customers, competitors, partners: never return people from these domains (your suppression list).",
            "items": {
              "type": "string"
            }
          },
          "excludeEmails": {
            "title": "Exclude emails (do-not-contact)",
            "type": "array",
            "description": "Never return these addresses: opt-outs, bounces, existing contacts.",
            "items": {
              "type": "string"
            }
          },
          "watch": {
            "title": "Watch mode: only new leads",
            "type": "boolean",
            "description": "Remember who earlier runs with the same settings delivered and return only new people. Schedule the run weekly for a fresh feed of new leads. Not available on the free plan.",
            "default": false
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Each batch of leads is POSTed here as JSON ({\"leads\": [...], \"run_id\": \"...\"}) for your CRM, Zapier, Make or n8n."
          },
          "slackWebhookUrl": {
            "title": "Slack incoming webhook",
            "type": "string",
            "description": "Posts a short summary with the top 5 leads when the run ends."
          },
          "hubspotToken": {
            "title": "HubSpot private app token",
            "type": "string",
            "description": "Push every lead with a verified email into your HubSpot contacts (created or updated by email, so re-runs never duplicate). Create a private app in HubSpot with the crm.objects.contacts.write scope and paste its access token here."
          },
          "simulateFree": {
            "title": "Simulate the free plan (developer test)",
            "type": "boolean",
            "description": "Developer-only switch.",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}