Skip to main content
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: 100
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
number
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,Q3
string
Comma-separated list of publication types. Valid values: journal, book series, conference
string
Sort order. Format: field:direction. Valid fields: score, citationCount, influentialCitationCount, quartileRanking, referenceCount, year
string
Filter by year. Format: YYYY (single year) or YYYY:YYYY (year range). Example: 2020 or 2020:2023
string[]
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 when scraperKey is provided, otherwise Pro credits if enrich=true, and Basic credits if enrich=false.