Skip to main content
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
}
'
{
  "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
  }
}

​
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
Enrichment (if enrich: true): +1 credit per company

​
Headers

​
x-api-key
string
required
Your API key for authentication

​
Body Parameters

​
keyword
string
required
Keyword to search for (company name, industry, etc.)
​
industry
string or array
Industry sector(s) (e.g., “technology” or [“technology”, “finance”, “healthcare”])
​
location
string or array
Location(s) (e.g., “Paris” or [“Paris”, “Lyon”, “Marseille”])
​
employee_range
string or array
Employee range(s) (e.g., “1-50” or [“1-50”, “51-200”, “201-1000”])
​
total_results
integer
default:"10"
Number of results to return
  • Minimum: 1
  • Maximum: 50,000
  • Default: 10
​
enrich
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…
Default: false (returns basic information only)

​
Response

​
status
string
Response status (“success” or “error”)
​
data
object
​
message
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
  }
}

​
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