Jobs API · Docs & request builder
Build a request. Copy the code.
Configure any query against the Jobs API, preview the exact URL, and copy a ready-to-run snippet in cURL, JavaScript, or Python. Everything below the builder is the full parameter and response reference.
GET
https://api.greatdatacompany.com/jobs·Authorization: Bearer <key>§ Request builder
Compose a request
§ Search & Filtering
Filter by one or more titles. Wrap in double quotes for exact match. Combine with OR / AND (not both).
Partial match by default. Use "Google" for exact match.
Use the full location string for best results. Combine with OR.
Full-text search across combined title and description.
Only jobs posted within the selected window.
Unix timestamp in seconds.
Unix timestamp in seconds.
When the job was indexed in our system.
When the job was indexed in our system.
§ AI-Derived Filters
Click chips to toggle. Joined with OR.
§ Salary
Numeric only, no currency symbols. Only applies to jobs with salary info.
§ Raw & Metadata Filters
The unique slug in linkedin.com/company/<slug>.
Extracted from the job page. Prefer ai_industries for standardized values.
§ Pagination & Output
Number of jobs to skip.
Between 10 and 1000. Default 100.
Excluded by default. Adds significant payload size.
GETRequest URL
https://api.greatdatacompany.com/jobs?title=Software%20Engineer&location=New%20York%2C%20NY%2C%20United%20States&ai_experience_levels=junior%20(1-3%20years)%20OR%20intermediate%20(4-7%20years)&salary_min=80000
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.greatdatacompany.com/jobs?title=Software%20Engineer&location=New%20York%2C%20NY%2C%20United%20States&ai_experience_levels=junior%20(1-3%20years)%20OR%20intermediate%20(4-7%20years)&salary_min=80000"
Get an API key
Keys are issued after a short intro call.
§ Query parameters
Parameter reference
All parameters are optional unless marked otherwise. Text filters support OR and AND (never combined). Wrap values in double quotes for exact matches.
Search & Filtering
| Parameter | Type | Default | Description |
|---|---|---|---|
title | text | — | Filter by one or more titles. Wrap in double quotes for exact match. Combine with OR / AND (not both). |
company | text | — | Partial match by default. Use "Google" for exact match. |
location | text | — | Use the full location string for best results. Combine with OR. |
query | text | — | Full-text search across combined title and description. |
timeframe | enum | 7d | Only jobs posted within the selected window. 1h24h7d30d |
posted_after | number (unix) | — | Unix timestamp in seconds. |
posted_before | number (unix) | — | Unix timestamp in seconds. |
created_after | number (unix) | — | When the job was indexed in our system. |
created_before | number (unix) | — | When the job was indexed in our system. |
AI-Derived Filters
| Parameter | Type | Default | Description |
|---|---|---|---|
ai_industries | array | — | Click chips to toggle. Joined with OR. Artificial Intelligence and Machine LearningCybersecurityData Science and AnalyticsEngineeringInformation TechnologySoftware EngineeringAccount Management and Customer SuccessAdministration and Office SupportBanking, Investment and InsuranceBusiness Development and PartnershipsBusiness Operations and StrategyCompliance, Risk and AuditConstruction and Skilled TradesContent, Communications and Public RelationsCustomer Service and SupportDesign and User ExperienceEducation and TrainingFinance and AccountingFinancial Planning and AnalysisGeneral OperationsGrowth and Performance MarketingHealthcareHuman ResourcesLegalLogistics and WarehousingManufacturing and ProductionMarketingProduct ManagementProject and Programme ManagementQuality Assurance and TestingRecruitment and Talent AcquisitionSalesSocial Care and Community ServicesSupply Chain and Procurement |
ai_experience_levels | array | — | AI experience levels entry-leveljunior (1-3 years)intermediate (4-7 years)experienced (8-12 years)expert & leadership (13+ years) |
ai_contract_types | array | — | AI contract types full timecontractorpart timeapprenticeshipinternship |
ai_work_environments | array | — | AI work environments hybridoffice full-timeremoteonsitefield |
Salary
| Parameter | Type | Default | Description |
|---|---|---|---|
salary_min | number | — | Numeric only, no currency symbols. Only applies to jobs with salary info. |
salary_max | number | — | Salary max |
Raw & Metadata Filters
| Parameter | Type | Default | Description |
|---|---|---|---|
li_company_slug | text | — | The unique slug in linkedin.com/company/<slug>. |
li_company_id | text | — | LinkedIn company ID |
industries | text | — | Extracted from the job page. Prefer ai_industries for standardized values. |
experience_levels | text | — | Experience levels (raw) |
contract_types | text | — | Contract types (raw) |
work_environments | text | — | Work environments (raw) |
Pagination & Output
| Parameter | Type | Default | Description |
|---|---|---|---|
offset | number | 0 | Number of jobs to skip. |
limit | number | 100 | Between 10 and 1000. Default 100. |
include_fields | array | — | Excluded by default. Adds significant payload size. description_htmldescription_text |
§ Response
Response fields
Envelope
limit- Echoed page size.
offset- Echoed offset.
credits_used- Credits consumed by this call.
data- Array of job records — see fields below.
Core details
job_id- Stable UUID for the job.
url- Canonical URL of the posting.
title- Job title as posted.
company- Company name.
posted_at- Unix seconds — when the job was posted.
created_at- Unix seconds — when we indexed the job.
locations- Raw locations as posted.
locations_derived- Normalized: Locality, Region, Country, PostalCode, Position [lng, lat].
Salary
salary- Original salary string.
salary_min / salary_max- Numeric bounds.
salary_currency- ISO currency, e.g. USD.
salary_period- hour, month, year, etc.
AI analysis
ai_industries- One or more standardized industries.
ai_experience_levels- Standardized experience buckets.
ai_contract_type- e.g. full time, contractor.
ai_work_environment- e.g. remote, hybrid, onsite.
ai_requirement_bullet_points- Extracted requirements.
ai_responsibility_bullet_points- Extracted responsibilities.
ai_benefit_bullet_points- Extracted benefits.
Raw metadata (as posted)
industries- Raw industries pulled from the posting.
experience_levels- Raw experience level(s), e.g. Entry level.
contract_types- Raw employment type, e.g. Full-time.
work_environments- Raw work environment, e.g. Remote, Hybrid.
job_functions- Raw job functions listed on the posting.
seniority- Raw seniority label when provided.
applicants_raw- Applicant count string as displayed by the source.
posted_raw- Raw 'posted' string, e.g. '2 days ago'.
Company
li_company_id- LinkedIn numeric company ID.
li_company_slug- LinkedIn slug.
li_company_url- LinkedIn company URL.
li_company_logo- Logo URL.
Raw & full content
description_text- Plain-text description (opt-in via include_fields).
description_html- HTML description (opt-in via include_fields).
bullet_points / paragraphs- Raw structured content extracted from the posting.
additional_data- Any extra source-specific fields not surfaced above.
§ Pagination
Paginating through your search results
The API uses offset-based pagination with the limit and offset parameters.
- Choose a
limit(up to1000). - Start with
offset: 0. - Increase
offsetbylimitafter each request. - Continue requesting pages until the API returns fewer jobs than the requested limit. This indicates you've reached the final page.
Example
Request 1: limit=1000, offset=0 → 1000 jobs Request 2: limit=1000, offset=1000 → 1000 jobs Request 3: limit=1000, offset=2000 → 437 jobs Since the final request returned fewer than 1000 jobs, there are no more results.
§ Example
Example response
Ready to plug in real data?
We'll get you an API key on a quick intro call and help you shape the first query.