Skip to main content
POST
/
accounts
/
search
Search accounts by filters
curl --request POST \
  --url https://app.pipecorn.com/api/v2/accounts/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "webhook_url": "https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8",
  "name": "Tech Companies in US",
  "included_industries": [
    "6"
  ],
  "excluded_industries": [
    "12"
  ],
  "included_locations": [
    "103644278"
  ],
  "company_size": [
    "51-200",
    "201-500"
  ],
  "keyword": "saas",
  "min_revenue": 10,
  "max_revenue": 100,
  "revenue_currency": "USD",
  "limit": 500,
  "streaming": false
}
'
import requests

url = "https://app.pipecorn.com/api/v2/accounts/search"

payload = {
    "webhook_url": "https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8",
    "name": "Tech Companies in US",
    "included_industries": ["6"],
    "excluded_industries": ["12"],
    "included_locations": ["103644278"],
    "company_size": ["51-200", "201-500"],
    "keyword": "saas",
    "min_revenue": 10,
    "max_revenue": 100,
    "revenue_currency": "USD",
    "limit": 500,
    "streaming": False
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    webhook_url: 'https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8',
    name: 'Tech Companies in US',
    included_industries: ['6'],
    excluded_industries: ['12'],
    included_locations: ['103644278'],
    company_size: ['51-200', '201-500'],
    keyword: 'saas',
    min_revenue: 10,
    max_revenue: 100,
    revenue_currency: 'USD',
    limit: 500,
    streaming: false
  })
};

fetch('https://app.pipecorn.com/api/v2/accounts/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.pipecorn.com/api/v2/accounts/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'webhook_url' => 'https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8',
    'name' => 'Tech Companies in US',
    'included_industries' => [
        '6'
    ],
    'excluded_industries' => [
        '12'
    ],
    'included_locations' => [
        '103644278'
    ],
    'company_size' => [
        '51-200',
        '201-500'
    ],
    'keyword' => 'saas',
    'min_revenue' => 10,
    'max_revenue' => 100,
    'revenue_currency' => 'USD',
    'limit' => 500,
    'streaming' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.pipecorn.com/api/v2/accounts/search"

	payload := strings.NewReader("{\n  \"webhook_url\": \"https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8\",\n  \"name\": \"Tech Companies in US\",\n  \"included_industries\": [\n    \"6\"\n  ],\n  \"excluded_industries\": [\n    \"12\"\n  ],\n  \"included_locations\": [\n    \"103644278\"\n  ],\n  \"company_size\": [\n    \"51-200\",\n    \"201-500\"\n  ],\n  \"keyword\": \"saas\",\n  \"min_revenue\": 10,\n  \"max_revenue\": 100,\n  \"revenue_currency\": \"USD\",\n  \"limit\": 500,\n  \"streaming\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://app.pipecorn.com/api/v2/accounts/search")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"webhook_url\": \"https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8\",\n  \"name\": \"Tech Companies in US\",\n  \"included_industries\": [\n    \"6\"\n  ],\n  \"excluded_industries\": [\n    \"12\"\n  ],\n  \"included_locations\": [\n    \"103644278\"\n  ],\n  \"company_size\": [\n    \"51-200\",\n    \"201-500\"\n  ],\n  \"keyword\": \"saas\",\n  \"min_revenue\": 10,\n  \"max_revenue\": 100,\n  \"revenue_currency\": \"USD\",\n  \"limit\": 500,\n  \"streaming\": false\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://app.pipecorn.com/api/v2/accounts/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"webhook_url\": \"https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8\",\n  \"name\": \"Tech Companies in US\",\n  \"included_industries\": [\n    \"6\"\n  ],\n  \"excluded_industries\": [\n    \"12\"\n  ],\n  \"included_locations\": [\n    \"103644278\"\n  ],\n  \"company_size\": [\n    \"51-200\",\n    \"201-500\"\n  ],\n  \"keyword\": \"saas\",\n  \"min_revenue\": 10,\n  \"max_revenue\": 100,\n  \"revenue_currency\": \"USD\",\n  \"limit\": 500,\n  \"streaming\": false\n}"

response = http.request(request)
puts response.read_body
{
  "message": "Account search started successfully. You will receive the results on your webhook shortly.",
  "id": "8e1dcba0-f0bb-4071-99fc-f18ba6559ccc",
  "total": 342,
  "preview": [
    {
      "company_name": "Pipecorn",
      "industry": "Technology, Information and Internet",
      "linkedin_id": "104885158",
      "linkedin_url": "https://www.linkedin.com/company/104885158"
    }
  ]
}
Search and extract company accounts using powerful filters including industry, location, company size, and keywords. This endpoint processes results asynchronously and sends enriched account data to your webhook URL.

​
Overview

This endpoint allows you to search for companies based on various criteria without needing to provide a LinkedIn Sales Navigator URL. The process is asynchronous - you’ll receive an immediate response with the import job details and a preview of matching accounts, and the complete enriched results will be sent to your webhook URL when processing is complete.

​
Rate Limits

  • 1 request per second per user/IP address

​
Search Filters

​
Industries

Target or exclude specific industries using industry IDs. Multiple industry IDs are combined with OR logic. Parameters:
  • included_industries: Array of industry IDs to target
  • excluded_industries: Array of industry IDs to exclude from results
For the complete list of industry IDs, see the LinkedIn Industry List. Common industry IDs include:
  • 4 - Automotive
  • 6 - Technology, Information and Internet
  • 12 - Education
  • 43 - Financial Services
  • 96 - Software Development

​
Locations

Use the Location IDs endpoint to find valid location IDs. You can include or exclude specific locations:
  • included_locations: Target specific countries, states, or cities
  • excluded_locations: Exclude specific locations from results

​
Company Size

Filter by employee count ranges:
  • 1-10 - Startup/Very Small
  • 11-50 - Small
  • 51-200 - Medium
  • 201-500 - Medium-Large
  • 501-1000 - Large
  • 1001-5000 - Very Large
  • 5001-10000 - Enterprise
  • 10001+ - Mega Corporation
Multiple size ranges can be used

​
Keyword

Search for companies by keyword in their name or description. This is useful for targeting specific niches or technologies (e.g., “saas”, “fintech”, “healthcare”).

​
Revenue

Filter companies by their annual revenue range. Revenue values are specified in millions and can be combined with a currency code. Parameters:
  • min_revenue: Minimum annual revenue (in millions). Valid values: 0, 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000
  • max_revenue: Maximum annual revenue (in millions). Valid values: 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1001 (where 1001 represents $1B+)
  • revenue_currency: Currency code for revenue values. Defaults to USD if not specified.
Supported currencies: USD, EUR, GBP, CAD, AUD, JPY, CNY, INR, BRL, SEK, NOK, DKK, SGD, HKD, NZD, THB, IDR, TRY, TWD, ILS, AED, RUB Example: To find companies with revenue between 10M−10M-50M: 
{
  "min_revenue": 10,
  "max_revenue": 50,
  "revenue_currency": "USD"
}

​
Limits

By default, the endpoint will process up to 1,000 matching accounts. You can set a lower limit using the limit parameter. The minimum of your specified limit and 1,000 will be used.

​
Streaming Mode

When streaming is set to true, results will be sent to your webhook in batches as they are processed, rather than all at once when complete. This is useful for large searches where you want to start processing results immediately.

​
Response

The endpoint returns immediately with:
  • A unique import job ID for tracking
  • The total number of accounts that will be processed
  • A preview of the first 10 matching accounts
The complete enriched results will be sent to your webhook URL when processing is complete.

​
Example Use Cases

​
Find SaaS companies in US tech hubs

{
  "webhook_url": "https://your-webhook.com/accounts",
  "name": "US Tech SaaS Companies",
  "included_industries": ["6", "96"],
  "included_locations": ["103644278"],
  "company_size": ["51-200", "201-500"],
  "keyword": "saas"
}

​
Target European fintech startups

{
  "webhook_url": "https://your-webhook.com/accounts",
  "name": "European Fintech Startups",
  "included_industries": ["43"],
  "included_locations": ["100506914", "105015875", "101165590"],
  "company_size": ["11-50", "51-200"],
  "limit": 500
}

​
Find large automotive companies excluding specific regions

{
  "webhook_url": "https://your-webhook.com/accounts",
  "name": "Global Automotive Giants",
  "included_industries": ["4"],
  "excluded_locations": ["102221843"],
  "company_size": ["5001-10000", "10001+"]
}

​
Find high-revenue tech companies in Europe

{
  "webhook_url": "https://your-webhook.com/accounts",
  "name": "High Revenue European Tech",
  "included_industries": ["6", "96"],
  "included_locations": ["100506914", "105015875"],
  "min_revenue": 100,
  "max_revenue": 1001,
  "revenue_currency": "EUR"
}

Authorizations

​
X-API-KEY
string
header
required

Your API key

Body

application/json
​
webhook_url
string<uri>
required

Webhook URL to receive the processed results

Example:

"https://webhook.site/8b53c96f-f2cd-4c24-bc09-b3c2176d7ea8"

​
name
string

Name for the import job

Example:

"Tech Companies in US"

​
included_industries
string[]

List of industry IDs to include in the search

Example:
["4", "6", "96"]
​
excluded_industries
string[]

List of industry IDs to exclude from the search

Example:
["12"]
​
included_locations
string[]

List of location IDs to include in the search. Use the /locations endpoint to get valid location IDs

Example:
["103644278", "105015875"]
​
excluded_locations
string[]

List of location IDs to exclude from the search

Example:
["102221843"]
​
company_size
enum<string>[]

Company size ranges to include

Available options:
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:
["11-50", "51-200"]
​
keyword
string

Keyword to search for in company names or descriptions

Example:

"saas"

​
min_revenue
enum<number>

Minimum annual revenue in millions. Valid values: 0, 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000

Available options:
0,
0.5,
1,
2.5,
5,
10,
20,
50,
100,
500,
1000
Example:

10

​
max_revenue
enum<number>

Maximum annual revenue in millions. Valid values: 0.5, 1, 2.5, 5, 10, 20, 50, 100, 500, 1000, 1001 (where 1001 represents $1B+)

Available options:
0.5,
1,
2.5,
5,
10,
20,
50,
100,
500,
1000,
1001
Example:

50

​
revenue_currency
enum<string>
default:USD

Currency code for revenue values. Defaults to USD if not specified

Available options:
USD,
EUR,
GBP,
CAD,
AUD,
JPY,
CNY,
INR,
BRL,
SEK,
NOK,
DKK,
SGD,
HKD,
NZD,
THB,
IDR,
TRY,
TWD,
ILS,
AED,
RUB
Example:

"USD"

​
limit
integer

Maximum number of accounts to extract (default: 1000)

Example:

100

​
streaming
boolean
default:false

Enable streaming mode for real-time results

Example:

false

​
live
boolean
default:true

Data source toggle. true (default) searches live through LinkedIn Sales Navigator and requires a connected Sales Navigator integration. false serves the count, preview, and extracted accounts from Pipecorn's companies database (Elasticsearch) instead, with no integration required. A non-boolean value returns 422.

Example:

true

Response

Account search started successfully

​
message
string
Example:

"Account search started successfully. You will receive the results on your webhook shortly."

​
id
string<uuid>

Unique identifier for the import job

Example:

"8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"

​
total
integer

Total number of accounts that will be processed

Example:

342

​
preview
object[]

Preview of the first 10 matching accounts