Skip to main content
POST
https://api.crustdata.com
/
job
/
search
curl --request POST \ --url https://api.crustdata.com/job/search \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'x-api-version: <x-api-version>' \ --data ' { "filters": { "op": "and", "conditions": [ { "field": "company.basic_info.company_id", "type": "=", "value": 631394 }, { "field": "job_details.category", "type": "=", "value": "Engineering" }, { "field": "metadata.date_added", "type": "=>", "value": "2025-01-01" } ] }, "fields": [ "job_details.title", "job_details.url", "metadata.date_added", "location.country" ], "sorts": [ { "field": "metadata.date_added", "order": "desc" } ], "limit": 2 } '
{ "job_listings": [ { "job_details": { "title": "Solutions Architect, AI (Pre-sales)", "url": "https://www.linkedin.com/jobs/view/4427154312" }, "location": { "country": "United States of America (the)" }, "metadata": { "date_added": "2026-06-11T02:23:55" } }, { "job_details": { "title": "Solutions Architect, Platforms Velocity", "url": "https://www.linkedin.com/jobs/view/4427016746" }, "location": { "country": "United States of America (the)" }, "metadata": { "date_added": "2026-06-10T14:23:59" } } ], "next_cursor": "H4sIALeAKmoC_xXMwQ6DIAwA0F8hnD1QSwvsV5bFVCjxsIxM8WAW_113f3k_-911PaZFtsU-jGUF4kS5SERJvjCpJiZklRJ4DJhBEaiq1LmQOh9nqhigZoiYE9jB2K2t_b6eECKAA4_JOTcYT0Qcwb9u0luX95Tb_vnLkTGcFxasau-KAAAA", "total_count": 2637 }

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header.

Headers

​
x-api-version
enum<string>
default:2025-11-01
required

API version to use. This endpoint currently requires 2025-11-01.

Available options:
2025-11-01
Example:

"2025-11-01"

Body

application/json

Search filters, pagination, sorting, field selection, and aggregations

Request body for searching the indexed job dataset with filters, pagination, sorting, field selection, and aggregations.

​
filters
object

Search filter conditions. Can be a single condition or a nested group combined with AND/OR logic. Only indexed fields are filterable — see SearchCondition.field for the full list.

Example:
{
  "field": "company.basic_info.company_id",
  "type": "=",
  "value": 631394
}
​
cursor
string

Opaque pagination cursor returned in a prior response's next_cursor field. Pass this to fetch the next page of results with the same filter, sort, and field selection.

Example:

"H4sIAJJG1mkC_xXMPQ7CMAwG0KtEmTvYiR0nXAWhyvlBHRARbTogxN0J01s-vY99nW1_r5sem70YSzEJErG_VwdSnfeMiVpSjhmbUmkanXqXa5rlqsUlTJApUPO1NrsYe_R9zNcVRZgDRhIAWAwhsA_Ct0lGH_pYSz-ffykR8PsDw2G2zooAAAA="

​
limit
integer
default:20

Maximum number of job listings to return per page. Set to 0 when you only want aggregations.

Required range: 0 <= x <= 1000
Example:

20

​
sorts
object[]

Sort specifications for ordering results. Sorts are applied in order.

Example:
[
  {
    "field": "metadata.date_added",
    "order": "desc"
  }
]
​
fields
string[]

Fields to return in each job listing. Use dot-notation for nested fields (e.g., "job_details.title", "company.basic_info.name"). If omitted, all available fields are returned.

Valid top-level groups: crustdata_job_id, job_details, company, location, content, metadata. Nested fields are supported (e.g., company.basic_info, company.headcount, company.funding).

Example:
[
  "job_details.title",
  "job_details.url",
  "company.basic_info.name",
  "location.raw",
  "metadata.date_added"
]
​
aggregations
object[]

Aggregation queries to run alongside the search. Set limit: 0 if you want only aggregation results and no job rows.

Example:
[
  {
    "type": "group_by",
    "field": "company.basic_info.company_id",
    "agg": "count",
    "size": 5
  }
]

Response

Jobs matching the search criteria with pagination cursor and total count

Paginated response from the indexed job search endpoint.

​
job_listings
object[]
required

Job listings matching the search criteria for the current page. Empty when limit is 0 or when an aggregation-only query is made.

Example:
[]
​
next_cursor
string | null

Opaque cursor for fetching the next page of results. Pass this value as cursor in the next request. null when there are no more pages.

Example:

"H4sIAJJG1mkC_xXMPQ7CMAwG0KtEmTvYiR0nXAWhyvlBHRARbTogxN0J01s-vY99nW1_r5sem70YSzEJErG_VwdSnfeMiVpSjhmbUmkanXqXa5rlqsUlTJApUPO1NrsYe_R9zNcVRZgDRhIAWAwhsA_Ct0lGH_pYSz-ffykR8PsDw2G2zooAAAA="

​
total_count
integer | null

Total number of job listings matching the query across all pages.

Example:

1676

​
aggregations
object[] | null

Aggregation results, present only when the request included an aggregations array.

Example:
[
  {
    "type": "count",
    "field": null,
    "value": 4448237
  }
]