Combined Search Job
Search Jobs
Combined Search Job
Create an asynchronous combined search job using keywords and/or query
POST
Combined Search Job
Create an asynchronous search job that can use keywords, a detailed query, or both. This provides the most flexible search option.
Parameters
number
default:"100"
Maximum number of results. Must be
100, 200, or 300. Default: 100string
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, Linguisticsnumber
Minimum number of citations. Must be a positive integer.
boolean
Filter for open access PDFs. Must be
true or false.boolean
Filter for downloadable papers. Must be
true or false.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,Q3string
Comma-separated list of publication types. Valid values:
journal, book series, conferencestring
Sort order. Format:
field:direction. Valid fields: score, citationCount, influentialCitationCount, quartileRanking, referenceCount, yearstring
Filter by year. Format:
YYYY (single year) or YYYY:YYYY (year range). Example: 2020 or 2020:2023string[]
Array of 3-10 keywords (string[], optional, but at least keywords or query required)
string
Detailed query string 50-5000 characters (optional, but at least keywords or query required)
string
Optional HTTPS URL for job completion callback
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.
boolean
default:"false"
Whether to enrich results. If
scraperKey is provided, enrichment is always enabled and Private Key credits are used.Response
Returns a job ID that can be used to check the job status.string
The unique identifier for the created job. Use this ID to check the job status via GET
/v1/job/{jobId}Credits
Credits are deducted immediately: 1 credit per 100 results requested. Uses Private Key credits whenscraperKey is provided, otherwise Pro credits if enrich=true, and Basic credits if enrich=false.