SuperSearchEnrichment

Preview leads from supersearch

Changed on

Preview the leads matching a SuperSearch query without enriching them

Requires one of the following scopes: supersearch_enrichments:read, supersearch_enrichments:all, all:read, all:all

post/api/v2/supersearch-enrichment/preview-leads-from-supersearch

Request

  • Base URL
    https://api.instantly.ai
  • Auth
    HTTP bearer

Request body

skip_owned_leadsboolean

Skip leads that belong to the current workspace

show_one_lead_per_companyboolean

Return only one lead per company

Example request

{
  "search_filters": {
    "company_list_id": "018f23b7-92bb-7c64-a3d4-1ba53b8ad971",
    "locations": [
      {
        "place_id": "ChIJN1t_t3uEmsRUso9K6W47H4",
        "label": "San Francisco, CA, USA"
      }
    ],
    "department": [
      "Engineering"
    ],
    "level": [
      "Entry level"
    ],
    "employeeCount": [
      "0 - 25"
    ],
    "revenue": [
      "$1 - 10M"
    ],
    "news": [
      "launches"
    ],
    "jobListing": [
      "Software Engineer"
    ],
    "jobListingFilter": [
      "Software Engineer"
    ],
    "title": {
      "include": [
        "CEO"
      ],
      "exclude": [
        "VP"
      ],
      "includeMode": "CONTAINS",
      "excludeMode": "CONTAINS"
    },
    "name": [
      "John Doe"
    ],
    "company_name": {
      "include": [
        "Google"
      ],
      "exclude": [
        "Amazon"
      ]
    },
    "businessType": {
      "include": [
        "agency"
      ],
      "exclude": [
        "staffing_recruiting"
      ]
    },
    "customerType": {
      "include": [
        "b2b"
      ],
      "exclude": [
        "b2c"
      ]
    },
    "look_alike": "google.com",
    "lookAlike": "google.com",
    "lookAlikeMode": "targeted",
    "technologies": [
      "Salesforce"
    ],
    "fundingType": [
      "seed"
    ],
    "locationMode": "contact",
    "keyword_filter": {
      "exclude": "sales",
      "include": "marketing",
      "include_mode": "ANY"
    },
    "industry": {
      "exclude": [
        "Agriculture & Mining"
      ],
      "include": [
        "Agriculture & Mining"
      ]
    },
    "subIndustry": {
      "exclude": [
        "Animation"
      ],
      "include": [
        "Animation"
      ]
    },
    "domains": [
      "google.com"
    ],
    "website_visitors": true,
    "funding_type": [
      "angel"
    ],
    "signals": [
      "job_change"
    ],
    "skip_owned_leads": true,
    "show_one_lead_per_company": true,
    "location_mode": "contact"
  },
  "skip_owned_leads": true,
  "show_one_lead_per_company": true
}

Response

Default Response

number_of_leadsnumber

Number of leads found for this specific search. A value of 0 indicates that no leads match the criteria. Values greater than 1,000,000 are returned as 1,000,000.

number_of_redacted_resultsnumber

Number of results that were redacted/hidden (for trial users).

Example response

{
  "number_of_leads": 100,
  "leads": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "fullName": "John Doe",
      "jobTitle": "Software Engineer",
      "location": "San Francisco, California, United States",
      "linkedIn": "linkedin.com/in/john-doe",
      "companyName": "Acme Corp",
      "companyLogo": "https://example.com/logo.png",
      "companyId": "123456",
      "isOwned": true,
      "identityHidden": true
    }
  ]
}

Changes

    • info

      added the non-success response with the status

    • breaking

      removed subschema #1 subschema #2 from the // request property oneOf list

    • breaking

      removed subschema #1 subschema #2 from the / request property oneOf list

    • breaking

      removed subschema #1 subschema #2 from the // request property oneOf list

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property /

    • info

      added subschema #1 subschema #2 to the / request property oneOf list

    • info

      added subschema #1 subschema #2 to the // request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 to the // request property oneOf list

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      removed the Not Found enum value from the response property for the response status