Skip to main content
POST
/
v1
/
data
/
companies
/
hiring
curl -X POST "https://api.linkupapi.com/api/v2/web-crawler/source-hiring-company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": ["developer"],
    "location": "Paris, France",
    "total_results": 10,
    "fetch_description": false,
    "enrich_company": false
  }'

{
  "status": "success",
  "data": {
    "companies": [
      {
        "name": "Alpic",
        "website": "https://www.alpic.ai",
        "indeed_url": null,
        "linkedin_url": "https://fr.linkedin.com/company/alpic-ai",
        "tagline": "Bring your product into the agent era.",
        "description": "Alpic provides the infrastructure and tools to turn your product into an AI-native experience...",
        "logo": "https://media.licdn.com/dms/image/.../alpic_ai_logo...",
        "cover_image": "https://media.licdn.com/dms/image/.../alpic_ai_cover...",
        "industry": "Technology, Information and Internet",
        "employee_count": 8,
        "employee_count_range": {
          "start": 2,
          "end": 10
        },
        "organization_type": "Privately Held",
        "headquarter": {
          "country": "FR",
          "city": "Paris"
        },
        "locations": [
          {
            "address": {
              "line1": "Paris, FR"
            },
            "headquarter": true
          }
        ],
        "followers_count": 1178,
        "jobs_count": 1,
        "jobs": [
          {
            "job_title": "Junior Software Engineer",
            "location": "Paris, Île-de-France, France",
            "job_type": null,
            "job_seniority": "",
            "job_board": "linkedin",
            "job_board_url": "https://www.linkedin.com/jobs/view/4300503473",
            "date_posted": "2025-09-13",
            "description": null,
            "is_remote": false,
            "salary": null
          }
        ]
      }
    ]
  },
  "pagination": {
    "start_page": 1,
    "end_page": 2,
    "results_per_page": 10,
    "pages_fetched": 2
  }
}

​
Overview

This endpoint retrieves companies that are actively hiring with their job listings, company details, and enriched data. At least one of job_title, job_description, or location is required.
Pricing: Total Cost = Base + Description + Enrichment
  • Base: 1 credit = 10 companies
  • Description (if fetch_description: true): +1 credit per 10 companies
  • Enrichment (if enrich_company: true): +1 credit per company
Examples for 10 companies:
  • Base only: 1 credit
  • Base + Description: 2 credits
  • Base + Enrichment: 11 credits
  • Full (Base + Description + Enrichment): 12 credits

​
Body Parameters

​
job_title
array
Keywords for job title (e.g., ["developer", "engineer"])
​
job_title_include_all
boolean
default:"false"
If true: all keywords required (AND logic). If false: at least one keyword (OR logic)
​
job_title_excluded
array
Keywords to exclude from job title (e.g., ["senior", "manager"])
​
location
string
Location (city, region). Example: "Paris, France" or "San Francisco, CA"
​
is_remote
boolean
default:"false"
Filter only remote jobs
​
country
string
default:"france"
Country for Indeed. Values: france, usa, uk, germany, spain, italy, canada
​
job_type
string
Type of contract. Values: fulltime, parttime, internship, contract
​
hours_old
integer
Jobs posted within the last X hours (e.g., 72 for 3 days)
​
site_names
array
default:"[\"indeed\", \"linkedin\"]"
Job boards to scrape. Values: linkedin, indeed
​
total_results
integer
default:"100"
Number of companies to retrieve
​
fetch_description
boolean
default:"true"
Fetch complete job descriptions. Cost: +1 credit per 10 companies
​
enrich_company
boolean
default:"false"
Enrich with LinkedIn data (tagline, followers, HQ, locations). Cost: +1 credit per company
​
start_page
integer
default:"1"
Start page for pagination
​
end_page
integer
End page for pagination

​
Response

​
companies
array
​
credits_cost
integer
Credits consumed for this request
​
credits_remaining
integer
Remaining credits in your account
​
nb_companies
integer
Number of companies returned
​
nb_jobs
integer
Total number of jobs found
curl -X POST "https://api.linkupapi.com/api/v2/web-crawler/source-hiring-company" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": ["developer"],
    "location": "Paris, France",
    "total_results": 10,
    "fetch_description": false,
    "enrich_company": false
  }'

{
  "status": "success",
  "data": {
    "companies": [
      {
        "name": "Alpic",
        "website": "https://www.alpic.ai",
        "indeed_url": null,
        "linkedin_url": "https://fr.linkedin.com/company/alpic-ai",
        "tagline": "Bring your product into the agent era.",
        "description": "Alpic provides the infrastructure and tools to turn your product into an AI-native experience...",
        "logo": "https://media.licdn.com/dms/image/.../alpic_ai_logo...",
        "cover_image": "https://media.licdn.com/dms/image/.../alpic_ai_cover...",
        "industry": "Technology, Information and Internet",
        "employee_count": 8,
        "employee_count_range": {
          "start": 2,
          "end": 10
        },
        "organization_type": "Privately Held",
        "headquarter": {
          "country": "FR",
          "city": "Paris"
        },
        "locations": [
          {
            "address": {
              "line1": "Paris, FR"
            },
            "headquarter": true
          }
        ],
        "followers_count": 1178,
        "jobs_count": 1,
        "jobs": [
          {
            "job_title": "Junior Software Engineer",
            "location": "Paris, Île-de-France, France",
            "job_type": null,
            "job_seniority": "",
            "job_board": "linkedin",
            "job_board_url": "https://www.linkedin.com/jobs/view/4300503473",
            "date_posted": "2025-09-13",
            "description": null,
            "is_remote": false,
            "salary": null
          }
        ]
      }
    ]
  },
  "pagination": {
    "start_page": 1,
    "end_page": 2,
    "results_per_page": 10,
    "pages_fetched": 2
  }
}
⌘I