Skip to main content
POST
Source Hiring Companies

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

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

Response

array
integer
Credits consumed for this request
integer
Remaining credits in your account
integer
Number of companies returned
integer
Total number of jobs found