Skip to main content
POST
/
v1
/
data
/
companies
/
jobs
curl -X POST "https://api.linkupapi.com/api/v2/web-crawler/company-jobs" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_names": ["Google", "Microsoft"],
    "total_results": 50,
    "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 all active job postings from specified companies. Unlike /companies/hiring which returns 1 job per company for discovery, this endpoint extracts every available job from the target companies.
The company_names parameter is required. Only LinkedIn will be scraped as the job board.
Pricing: Total Cost = Base + Description + Enrichment
  • Base: ⌈jobs / 10⌉ credits (1 credit = 10 jobs)
  • Description (if fetch_description: true): +1 credit = 10 description
  • Enrichment (if enrich_company: true): +1 credit per company
Examples for 50 jobs from 2 companies:
  • Base only: 5 credits
  • Base + Description: 6 credits
  • Base + Enrichment: 7 credits
  • Full (Base + Description + Enrichment): 8 credits

Body Parameters

company_names
array
required
List of company names to extract jobs from (e.g., ["Google", "Amazon"])
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
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)
total_results
integer
default:"100"
Maximum number of jobs to retrieve per company
fetch_description
boolean
default:"true"
Fetch complete job descriptions. Cost: +⌈companies / 10⌉ credits
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/company-jobs" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_names": ["Google", "Microsoft"],
    "total_results": 50,
    "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