> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veritus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Combined Search Job

> Create an asynchronous combined search job using keywords and/or query

Create an asynchronous search job that can use keywords, a detailed query, or both. This provides the most flexible search option.

## Parameters

<ParamField query="limit" type="number" default="100">
  Maximum number of results. Must be `100`, `200`, or `300`. Default: `100`
</ParamField>

<ParamField query="fieldsOfStudy" type="string">
  Comma-separated list of fields of study. Valid values: `Computer Science`, `Medicine`, `Chemistry`, `Biology`, `Materials Science`, `Physics`, `Geology`, `Psychology`, `Art`, `History`, `Geography`, `Sociology`, `Business`, `Political Science`, `Economics`, `Philosophy`, `Mathematics`, `Engineering`, `Environmental Science`, `Agricultural and Food Sciences`, `Education`, `Law`, `Linguistics`
</ParamField>

<ParamField query="minCitationCount" type="number">
  Minimum number of citations. Must be a positive integer.
</ParamField>

<ParamField query="openAccessPdf" type="boolean">
  Filter for open access PDFs. Must be `true` or `false`.
</ParamField>

<ParamField query="downloadable" type="boolean">
  Filter for downloadable papers. Must be `true` or `false`.
</ParamField>

<ParamField query="quartileRanking" type="string">
  Filter by quartile ranking(s). Can be a single value or comma-separated list. Valid values: `Q1`, `Q2`, `Q3`, `Q4`. Example: `Q1` or `Q1,Q2,Q3`
</ParamField>

<ParamField query="publicationTypes" type="string">
  Comma-separated list of publication types. Valid values: `journal`, `book series`, `conference`
</ParamField>

<ParamField query="sort" type="string">
  Sort order. Format: `field:direction`. Valid fields: `score`, `citationCount`, `influentialCitationCount`, `quartileRanking`, `referenceCount`, `year`
</ParamField>

<ParamField query="year" type="string">
  Filter by year. Format: `YYYY` (single year) or `YYYY:YYYY` (year range). Example: `2020` or `2020:2023`
</ParamField>

<ParamField body="keywords" type="string[]">
  Array of 3-10 keywords (string\[], optional, but at least keywords or query required)
</ParamField>

<ParamField body="query" type="string">
  Detailed query string 50-5000 characters (optional, but at least keywords or query required)
</ParamField>

<ParamField body="callbackUrl" type="string">
  Optional HTTPS URL for job completion callback
</ParamField>

<ParamField body="scraperKey" type="string">
  Optional Firecrawl API key. If provided, Private Key credits are used, enrichment is always enabled, and the key must be valid with at least 50 remaining Firecrawl credits.
</ParamField>

<ParamField body="enrich" type="boolean" default="false">
  Whether to enrich results. If `scraperKey` is provided, enrichment is always enabled and Private Key credits are used.
</ParamField>

## Response

Returns a job ID that can be used to check the job status.

<ResponseField name="jobId" type="string">
  The unique identifier for the created job. Use this ID to check the job status via GET `/v1/job/{jobId}`
</ResponseField>

## Credits

Credits are deducted immediately: 1 credit per 100 results requested. Uses Private Key credits when `scraperKey` is provided, otherwise Pro credits if `enrich=true`, and Basic credits if `enrich=false`.