Keyword Search Job
Search Jobs
Keyword Search Job
Create an asynchronous keyword search job
POST
Keyword Search Job
Create an asynchronous search job using keywords. This job type requires 3-10 keywords.
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[]
required
Array of 3-10 keywords (string[])
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.