PitchBook: Service Provider Search

Service Provider Search.

Tool ID: pitchbook_service_provider_search

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'pitchbook_service_provider_search',
  {
    "serviceProviderNames": "example",
    "serviceProviderType": "example",
    "city": "San Francisco"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute pitchbook_service_provider_search --input '{
  "serviceProviderNames": "example",
  "serviceProviderType": "example",
  "city": "San Francisco"
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "stats": {
      "total": 123,
      "perPage": 123,
      "page": 123
    },
    "items": [
      {
        "serviceProviderId": "service_provider_123",
        "serviceProviderName": "Example",
        "sandbox": true
      }
    ]
  }
}

Use deepline tools get pitchbook_service_provider_search --json for the latest machine-readable contract.

Input reference

Retrieves service providers matching the specified criteria

Name	Type	Required	Default	Details
`payload.serviceProviderNames`	`string`	No	—	Accepts service provider names, pbIds, websites, and tickers. Returns a list of service providers that are an exact match. Use a comma to separate multiple values
`payload.serviceProviderType`	`string`	No	—	Service providers can be found by their service service provider type code
`payload.city`	`string`	No	—	Search for service providers by their city location
`payload.stateProvince`	`string`	No	—	Search for service providers by their state code or province code
`payload.country`	`string`	No	—	Search for service providers by their country code
`payload.postCode`	`string`	No	—	Search for service providers by their postcode, included to support searching for both US postal code and foreign
`payload.locationType`	`string`	No	—	Search for service providers by additional parameter specifying HQ Only (HQ_ONLY), Non-HQ Only (NON_HQ_ONLY) or any office location (ANY) values. Set this parameter in pair with city, stateProvince, country, postCode options
`payload.hiredForGeneralServices`	`string`	No	—	Find service providers hired for general services to other entities. Set this parameter as True
`payload.hiredForFundraising`	`string`	No	—	Find service providers hired for services on a fund to other entities. Set this parameter as True
`payload.hiredForDealWork`	`string`	No	—	Find service providers hired for services on a deal to other entities. Set this parameter as True
`payload.numberOfDeals`	`string`	No	—	Search for service providers by the serviced deals. Find service providers with a deals count greater than a value using the > operator, service providers with a deals count smaller than a value using the < operator and service providers with a deals count between values using the ^ operator
`payload.dealDate`	`string`	No	—	Find service providers who have been hired for a deal within a certain time frame. Search for service providers hired for a deal after a certain date using the > operator, service providers hired for a deal before a certain date using the < operator and service providers hired for a deal between 2 dates using the ^ operator. Format: YYYY-MM-DD
`payload.dealSize`	`string`	No	—	Find service providers who have been hired for deals of a certain size. Search for service providers hired for deals larger than an amount using the > operator, service providers hired for deals smaller than a certain amount using the < operator and service providers hired for deals in a range using the ^ operator. Amounts in millions
`payload.includeDealsWithoutDealSize`	`string`	No	—	Include service providers on deals without a known deal size. Set this parameter as True only when Deal Size parameter is applied. False by default
`payload.excludeDealsWithoutDealSize`	`string`	No	—	Exclude service providers on deals without a known deal size. Set this parameter as True only when Deal Size parameter is not applied. False by default
`payload.dealType`	`string`	No	—	Find service providers by the types of deals they have been hired for. Pass a deal type code
`payload.serviceTypesOnDeal`	`string`	No	—	Find service providers by the service types within the deals they have been hired for. Pass a service type on deal code
`payload.companyStateProvince`	`string`	No	—	Search for service providers hired for services to companies by their state code or province code
`payload.companyCountry`	`string`	No	—	Search for service providers hired for services to companies by their country code
`payload.companyLocationType`	`string`	No	—	Search for service providers hired for services to companies by additional parameter specifying HQ Only (HQ_ONLY), Non-HQ Only (NON_HQ_ONLY) or any office location (ANY) values. Set this parameter in pair with companyStateProvince, companyCountry
`payload.companyUniverse`	`string`	No	—	Search for service providers hired for services to companies by their universe code
`payload.companyKeywords`	`string`	No	—	Search for service providers hired for services to companies by their keywords
`payload.companyIndustry`	`string`	No	—	Search for service providers hired for services to companies by their industries via industry code
`payload.companyVerticals`	`string`	No	—	Search for service providers hired for services to companies by their verticals via vertical code
`payload.companyIndustryAndVertical`	`string`	No	—	When using both company industry and company vertical, “OR” logic is used by default. To use “AND” logic, set this parameter to True
`payload.currency`	`string`	No	—	Specify the currency that your other parameters, such as dealSize, are entered as. It depends on the currency in user preferences
`payload.page`	`string`	No	—	Results are returned so that they can be paged through. Set this parameter to increment the page
`payload.perPage`	`string`	No	—	How many returned results show on page

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.stats`	`object`	No	—	—
`result.data.stats.total`	`integer`	No	—	Format: `int32`.
`result.data.stats.perPage`	`integer`	No	—	Format: `int32`.
`result.data.stats.page`	`integer`	No	—	Format: `int32`.
`result.data.stats.lastPage`	`integer`	No	—	Format: `int32`.
`result.data.items`	`array`	No	—	—
`result.data.items[].serviceProviderId`	`string`	No	—	—
`result.data.items[].serviceProviderName`	`string`	No	—	—
`result.data.items[].sandbox`	`boolean`	No	—	—
`result.data.items[].website`	`string`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Get started

Build and automate

Common workflows

Data and integrations

Reference

PitchBook: Service Provider Search

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation