Search Companies
curl --request POST \
--url https://api.linkupapi.com/v1/data/search/companies \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"keyword": "<string>",
"industry": {},
"location": {},
"employee_range": {},
"total_results": 123,
"enrich": true
}
'import requests
url = "https://api.linkupapi.com/v1/data/search/companies"
payload = {
"keyword": "<string>",
"industry": {},
"location": {},
"employee_range": {},
"total_results": 123,
"enrich": True
}
headers = {
"x-api-key": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
keyword: '<string>',
industry: {},
location: {},
employee_range: {},
total_results: 123,
enrich: true
})
};
fetch('https://api.linkupapi.com/v1/data/search/companies', 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://api.linkupapi.com/v1/data/search/companies",
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([
'keyword' => '<string>',
'industry' => [
],
'location' => [
],
'employee_range' => [
],
'total_results' => 123,
'enrich' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-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://api.linkupapi.com/v1/data/search/companies"
payload := strings.NewReader("{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-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://api.linkupapi.com/v1/data/search/companies")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/search/companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 2,
"companies": [
{
"name": "AI Agents",
"universalName": "buildanaiagent",
"description": "🌐 Build an AI Agent – GPT Automation & Custom Solutions\n\nWe help businesses build custom AI agents to automate repetitive tasks and optimize workflows using GPT and API integrations.\n\n💡 Our mission:\nEmpower entrepreneurs, startups, and companies to save time and scale their operations with tailored AI solutions.\n\n🚀 What We Offer:\n\nCustom GPT-powered AI agents\nAPI-driven task automation\nWorkflow optimization with AI\n🧑💻 Build your first AI agent today",
"tagline": "Build AI-Powered Agents – Automate, Optimize, and Scale Your Business 24/7",
"websiteUrl": "https://createagentai.co",
"industry": "Information Services",
"employeeCount": 2,
"employeeCountRange": null,
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Québec",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/D4D0BAQGhEJ-wfzNQHg/company-logo_200_200/B4DZV0PvhqHkAM-/0/1741412039022/buildanaiagent_logo?e=2147483647&v=beta&t=jlXqKwQcaB1UPYaeghB0_WLT2TZxeJTaZocSIn_-ymc",
"coverImageUrl": "https://media.licdn.com/dms/image/v2/D4D3DAQFr87Z8ObqpWw/image-scale_191_1128/B4DZV2QzunGkAk-/0/1741445872827/buildanaiagent_cover?e=2147483647&v=beta&t=qSRP_pEEEmVazEJKqIRKkGg7TyFROVIW_WQHdcYzxT8",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Québec, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Self-Employed",
"defaultLocale": "en",
"followersCount": 355,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/buildanaiagent"
},
{
"name": "The AI Agent",
"universalName": "the-ai-agent",
"description": "Our real estate SaaS platform is designed to give agents the tools they need to succeed in today's competitive market. With our easy-to-use 3-click setup, automated lead acquisition, and unlimited follow up capabilities - you'll be able to save hundreds of hours per year and gain 10-20 more sales while you're at it.",
"tagline": "Helping Realtors Automate Their Entire Lead Generation Processes",
"websiteUrl": "https://theaiagent.io/",
"industry": "Real Estate",
"employeeCount": 1,
"employeeCountRange": {
"start": 2,
"end": 10
},
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Calgary",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/C560BAQEVPK6jyLrySw/company-logo_200_200/company-logo_200_200/0/1673860422851?e=2147483647&v=beta&t=ogKjT_J156h9gNYqSODy0KhXFjeyWRlo6czi7zMdYDI",
"coverImageUrl": "https://static.licdn.com/aero-v1/sc/h/5q92mjc5c51bjlwaj3rs9aa82",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Calgary, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Privately Held",
"defaultLocale": "en",
"followersCount": 269,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/the-ai-agent"
}
],
"enriched": true
}
}
{
"status": "success",
"data": {
"total_results": 2847,
"companies": [
{
"url": "https://uk.linkedin.com/company/crm.com",
"title": "CRM.COM - LinkedIn",
"description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
},
{
"url": "https://www.linkedin.com/company/recruitcrm",
"title": "Recruit CRM - LinkedIn",
"description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
},
{
"url": "https://www.linkedin.com/company/aesthetix-crm",
"title": "Aesthetix CRM - LinkedIn",
"description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
}
]
}
}
Web Crawler API
Search Companies
Search company pages with advanced filters
POST
/
v1
/
data
/
search
/
companies
Search Companies
curl --request POST \
--url https://api.linkupapi.com/v1/data/search/companies \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '
{
"keyword": "<string>",
"industry": {},
"location": {},
"employee_range": {},
"total_results": 123,
"enrich": true
}
'import requests
url = "https://api.linkupapi.com/v1/data/search/companies"
payload = {
"keyword": "<string>",
"industry": {},
"location": {},
"employee_range": {},
"total_results": 123,
"enrich": True
}
headers = {
"x-api-key": "<x-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': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
keyword: '<string>',
industry: {},
location: {},
employee_range: {},
total_results: 123,
enrich: true
})
};
fetch('https://api.linkupapi.com/v1/data/search/companies', 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://api.linkupapi.com/v1/data/search/companies",
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([
'keyword' => '<string>',
'industry' => [
],
'location' => [
],
'employee_range' => [
],
'total_results' => 123,
'enrich' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-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://api.linkupapi.com/v1/data/search/companies"
payload := strings.NewReader("{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-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://api.linkupapi.com/v1/data/search/companies")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/data/search/companies")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"keyword\": \"<string>\",\n \"industry\": {},\n \"location\": {},\n \"employee_range\": {},\n \"total_results\": 123,\n \"enrich\": true\n}"
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"total_results": 2,
"companies": [
{
"name": "AI Agents",
"universalName": "buildanaiagent",
"description": "🌐 Build an AI Agent – GPT Automation & Custom Solutions\n\nWe help businesses build custom AI agents to automate repetitive tasks and optimize workflows using GPT and API integrations.\n\n💡 Our mission:\nEmpower entrepreneurs, startups, and companies to save time and scale their operations with tailored AI solutions.\n\n🚀 What We Offer:\n\nCustom GPT-powered AI agents\nAPI-driven task automation\nWorkflow optimization with AI\n🧑💻 Build your first AI agent today",
"tagline": "Build AI-Powered Agents – Automate, Optimize, and Scale Your Business 24/7",
"websiteUrl": "https://createagentai.co",
"industry": "Information Services",
"employeeCount": 2,
"employeeCountRange": null,
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Québec",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/D4D0BAQGhEJ-wfzNQHg/company-logo_200_200/B4DZV0PvhqHkAM-/0/1741412039022/buildanaiagent_logo?e=2147483647&v=beta&t=jlXqKwQcaB1UPYaeghB0_WLT2TZxeJTaZocSIn_-ymc",
"coverImageUrl": "https://media.licdn.com/dms/image/v2/D4D3DAQFr87Z8ObqpWw/image-scale_191_1128/B4DZV2QzunGkAk-/0/1741445872827/buildanaiagent_cover?e=2147483647&v=beta&t=qSRP_pEEEmVazEJKqIRKkGg7TyFROVIW_WQHdcYzxT8",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Québec, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Self-Employed",
"defaultLocale": "en",
"followersCount": 355,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/buildanaiagent"
},
{
"name": "The AI Agent",
"universalName": "the-ai-agent",
"description": "Our real estate SaaS platform is designed to give agents the tools they need to succeed in today's competitive market. With our easy-to-use 3-click setup, automated lead acquisition, and unlimited follow up capabilities - you'll be able to save hundreds of hours per year and gain 10-20 more sales while you're at it.",
"tagline": "Helping Realtors Automate Their Entire Lead Generation Processes",
"websiteUrl": "https://theaiagent.io/",
"industry": "Real Estate",
"employeeCount": 1,
"employeeCountRange": {
"start": 2,
"end": 10
},
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Calgary",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/C560BAQEVPK6jyLrySw/company-logo_200_200/company-logo_200_200/0/1673860422851?e=2147483647&v=beta&t=ogKjT_J156h9gNYqSODy0KhXFjeyWRlo6czi7zMdYDI",
"coverImageUrl": "https://static.licdn.com/aero-v1/sc/h/5q92mjc5c51bjlwaj3rs9aa82",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Calgary, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Privately Held",
"defaultLocale": "en",
"followersCount": 269,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/the-ai-agent"
}
],
"enriched": true
}
}
{
"status": "success",
"data": {
"total_results": 2847,
"companies": [
{
"url": "https://uk.linkedin.com/company/crm.com",
"title": "CRM.COM - LinkedIn",
"description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
},
{
"url": "https://www.linkedin.com/company/recruitcrm",
"title": "Recruit CRM - LinkedIn",
"description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
},
{
"url": "https://www.linkedin.com/company/aesthetix-crm",
"title": "Aesthetix CRM - LinkedIn",
"description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
}
]
}
}
Description
This endpoint allows you to search company pages using various advanced filtering criteria.Credit Usage: 1 credit per 10 results (or fraction thereof). For example:
- 1-10 results = 1 credit
- 11-20 results = 2 credits
- 300 results = 30 credits
Headers
string
required
Your API key for authentication
Body Parameters
string
required
Keyword to search for (company name, industry, etc.)
string or array
Industry sector(s) (e.g., “technology” or [“technology”, “finance”, “healthcare”])
string or array
Location(s) (e.g., “Paris” or [“Paris”, “Lyon”, “Marseille”])
string or array
Employee range(s) (e.g., “1-50” or [“1-50”, “51-200”, “201-1000”])
integer
default:"10"
Number of results to return
- Minimum: 1
- Maximum: 50,000
- Default: 10
boolean
default:"false"
Retrieve enriched company data with detailed informationWhen set to
true, returns comprehensive company details including:- Complete company profile information
- Employee count and ranges
- Headquarters and locations
- Logo and cover images
- Funding information
- Organization type
- And more…
false (returns basic information only)Response
string
Response status (“success” or “error”)
object
Show Response Data
Show Response Data
integer
Total count of all matching results
array
List of found companies
Show Company Structure (Basic)
Show Company Structure (Basic)
Show Company Structure (Enriched - when enrich=true)
Show Company Structure (Enriched - when enrich=true)
string
Company name
string
LinkedIn universal name/identifier
string
Detailed company description
string
Company tagline/slogan
string
Official company website URL
string
Company industry sector
integer
Current employee count
object
Employee count range (start and end)
object
Headquarters location details (country, city, etc.)
string
Company logo image URL
string
Company cover/banner image URL
object
Call to action information
array
List of company locations
string
Organization type (e.g., “Privately Held”, “Self-Employed”)
string
Default language locale
integer
Number of LinkedIn followers
boolean
Whether page mailbox is enabled
boolean
Whether the company is verified
object
string
Full LinkedIn company profile URL
boolean
Indicates if results are enriched (true when enrich=true)
string
Error message (if status = “error”)
{
"status": "success",
"data": {
"total_results": 2,
"companies": [
{
"name": "AI Agents",
"universalName": "buildanaiagent",
"description": "🌐 Build an AI Agent – GPT Automation & Custom Solutions\n\nWe help businesses build custom AI agents to automate repetitive tasks and optimize workflows using GPT and API integrations.\n\n💡 Our mission:\nEmpower entrepreneurs, startups, and companies to save time and scale their operations with tailored AI solutions.\n\n🚀 What We Offer:\n\nCustom GPT-powered AI agents\nAPI-driven task automation\nWorkflow optimization with AI\n🧑💻 Build your first AI agent today",
"tagline": "Build AI-Powered Agents – Automate, Optimize, and Scale Your Business 24/7",
"websiteUrl": "https://createagentai.co",
"industry": "Information Services",
"employeeCount": 2,
"employeeCountRange": null,
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Québec",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/D4D0BAQGhEJ-wfzNQHg/company-logo_200_200/B4DZV0PvhqHkAM-/0/1741412039022/buildanaiagent_logo?e=2147483647&v=beta&t=jlXqKwQcaB1UPYaeghB0_WLT2TZxeJTaZocSIn_-ymc",
"coverImageUrl": "https://media.licdn.com/dms/image/v2/D4D3DAQFr87Z8ObqpWw/image-scale_191_1128/B4DZV2QzunGkAk-/0/1741445872827/buildanaiagent_cover?e=2147483647&v=beta&t=qSRP_pEEEmVazEJKqIRKkGg7TyFROVIW_WQHdcYzxT8",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Québec, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Self-Employed",
"defaultLocale": "en",
"followersCount": 355,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/buildanaiagent"
},
{
"name": "The AI Agent",
"universalName": "the-ai-agent",
"description": "Our real estate SaaS platform is designed to give agents the tools they need to succeed in today's competitive market. With our easy-to-use 3-click setup, automated lead acquisition, and unlimited follow up capabilities - you'll be able to save hundreds of hours per year and gain 10-20 more sales while you're at it.",
"tagline": "Helping Realtors Automate Their Entire Lead Generation Processes",
"websiteUrl": "https://theaiagent.io/",
"industry": "Real Estate",
"employeeCount": 1,
"employeeCountRange": {
"start": 2,
"end": 10
},
"headquarter": {
"country": "CA",
"geographicArea": null,
"city": "Calgary",
"line2": null,
"line1": null,
"postalCode": null
},
"logoUrl": "https://media.licdn.com/dms/image/v2/C560BAQEVPK6jyLrySw/company-logo_200_200/company-logo_200_200/0/1673860422851?e=2147483647&v=beta&t=ogKjT_J156h9gNYqSODy0KhXFjeyWRlo6czi7zMdYDI",
"coverImageUrl": "https://static.licdn.com/aero-v1/sc/h/5q92mjc5c51bjlwaj3rs9aa82",
"callToAction": null,
"locations": [
{
"streetAddressOptOut": false,
"description": "Primary",
"address": {
"country": null,
"geographicArea": null,
"city": null,
"line2": null,
"line1": "Calgary, CA",
"postalCode": null
},
"headquarter": true
}
],
"organizationType": "Privately Held",
"defaultLocale": "en",
"followersCount": 269,
"pageMailbox": false,
"verified": false,
"funding": {
"isFunded": false,
"totalRounds": null,
"lastRound": null,
"investors": []
},
"company_url": "https://www.linkedin.com/company/the-ai-agent"
}
],
"enriched": true
}
}
{
"status": "success",
"data": {
"total_results": 2847,
"companies": [
{
"url": "https://uk.linkedin.com/company/crm.com",
"title": "CRM.COM - LinkedIn",
"description": "CRM.COM is a global specialist in designing and developing commerce, fintech and subscription-based solutions, ideal for the new generation digital consumers."
},
{
"url": "https://www.linkedin.com/company/recruitcrm",
"title": "Recruit CRM - LinkedIn",
"description": "Recruit CRM builds cloud-based software for the global Recruitment & Staffing industry. We are on a mission to help recruitment firms grow faster with cutting ..."
},
{
"url": "https://www.linkedin.com/company/aesthetix-crm",
"title": "Aesthetix CRM - LinkedIn",
"description": "The #1 CRM platform for plastic surgeons and medical spas. Aesthetix CRM gives your practice access to all the tools you need to grow."
}
]
}
}
Important Notes
- Credit consumption is based on the number of results: 1 credit for 1-10 results, 2 credits for 11-20 results, etc.
- Credits are only deducted on successful searches
Was this page helpful?