Apollo (API Key) ACTION
Search For Organizations
Search the Apollo database for companies (organizations) using filters such as name, domain, employee count, location, technologies, revenue, funding, and job postings. See the documentation
- Action
- Read only
- API key
- SDK
- MCP
IMPLEMENTATION
Call this tool
Connect a user's Apollo (API Key) account once, then configure and run Search For Organizations from your backend or agent.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "apollo_io-organization-search",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
apollo_io: { authProvisionId: "apn_xxxxxxx" },
qOrganizationName: "Organization Name",
qOrganizationDomainsList: ["Organization Domains"],
},
})
console.log(result)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "apollo_io-organization-search",
"configured_props": {
"apollo_io": { "authProvisionId": "apn_xxxxxxx" },
"qOrganizationName": "Organization Name",
"qOrganizationDomainsList": ["Organization Domains"]
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "apollo_io",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "apollo_io-organization-search",
arguments: {
qOrganizationName: "Organization Name",
qOrganizationDomainsList: ["Organization Domains"],
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| Property | Type | Description |
|---|---|---|
qOrganizationName Organization Name | string | Company name to search for (partial matches supported) Optional |
qOrganizationDomainsList Organization Domains | string[] | Company domains to match (no www, no @). Example: ["apollo.io", "google.com"] Optional |
organizationIds Organization IDs | string[] | Specific Apollo organization IDs to filter results to Optional Dynamic |
organizationNumEmployeesRanges Organization Employee Ranges | string[] | Employee count ranges, formatted as min,max. Example: ["1,10", "250,500"] Optional |
organizationLocations Organization Locations | string[] | HQ locations to include. Example: ["texas", "tokyo", "spain"] Optional |
organizationNotLocations Excluded Organization Locations | string[] | HQ locations to exclude from results Optional |
currentlyUsingAnyOfTechnologyUids Technologies (UIDs) | string[] | Apollo technology UIDs the company uses. Example: ["salesforce", "google_analytics"] Optional |
qOrganizationKeywordTags Organization Keyword Tags | string[] | Keyword tags describing the company industry/focus. Example: ["sales strategy", "lead generation"] Optional |
revenueRangeMin Revenue Range Min | integer | Minimum annual revenue (USD) Optional |
revenueRangeMax Revenue Range Max | integer | Maximum annual revenue (USD) Optional |
latestFundingAmountMin Latest Funding Amount Min | integer | Minimum latest funding round amount (USD) Optional |
latestFundingAmountMax Latest Funding Amount Max | integer | Maximum latest funding round amount (USD) Optional |
totalFundingMin Total Funding Min | integer | Minimum total funding raised (USD) Optional |
totalFundingMax Total Funding Max | integer | Maximum total funding raised (USD) Optional |
latestFundingDateMin Latest Funding Date After | string | Earliest date of the latest funding round (YYYY-MM-DD) Optional |
latestFundingDateMax Latest Funding Date Before | string | Latest date of the latest funding round (YYYY-MM-DD) Optional |
qOrganizationJobTitles Org Job Posting Titles | string[] | Job posting titles the company is hiring for Optional |
organizationJobLocations Org Job Posting Locations | string[] | Locations of job postings at the company Optional |
organizationNumJobsMin Org Open Jobs Min | integer | Minimum number of open job postings Optional |
organizationNumJobsMax Org Open Jobs Max | integer | Maximum number of open job postings Optional |
organizationJobPostedAtMin Org Job Posted After | string | Earliest date a job was posted (YYYY-MM-DD) Optional |
organizationJobPostedAtMax Org Job Posted Before | string | Latest date a job was posted (YYYY-MM-DD) Optional |
REFERENCE
Tool details
Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.
- Registry key
- apollo_io-organization-search
- Version
- 0.0.2
- App
- Apollo (API Key)
- Authentication
- API key
- Read-only
- Yes
- Destructive
- No
- Open world
- Yes
- Source
- View on GitHub ↗