Black Falcon Data

Posted on Aug 21 Edited on Aug 24

Every field the Seek API returns (73)

#webscraping #api

The Seek API produces 73 fields per record. Below is the complete field list, what each group contains, which values may come back empty, what our own Seek Actor costs, and where its coverage ends.

Coverage is Australia and New Zealand.

Every field

Every row contains 73 fields, organized into these groups:

company — company, companyUrl, companyIndustry, companySize, companyWebsite, companyDescription, companyLogo, companyCoverImageUrl, companyPerks, companySearchUrl, companyReviewRating, companyReviewCount
location — location, locationCountry, locationState, locationSuburb, locationPostcode
salary — salaryText, salaryMin, salaryMax, salaryCurrency, salaryType
description — description, descriptionHtml, descriptionMarkdown, descriptionLength
job — jobId, jobScore, jobScoreReasons
is — isVerifiedAdvertiser, isSponsored, isRepost
contact — contactName, contactEmail, contactPhone
source — sourceUrl, sourceCountry, sourceDomain
extracted — extractedEmails, extractedPhones, extractedUrls
category — category, categoryId
sub — subCategory, subCategoryId
content — contentQuality, contentHash
apply — applyEmail, applyUrl
applicant — applicantCount, applicantVolumeLabel
search — searchQuery, searchUrl
repost — repostOfId, repostDetectedAt

This actual record from a run has been cut to the leading fields:

{
 "jobId": "f047cfa35f820db1076061549cb815edeac9b2496740af0bdd56be931031a22b",
 "seekJobId": "94033849",
 "title": "Full Stack Developer",
 "canonicalUrl": "https://au.seek.com/job/94033849",
 "company": "Alzaro",
 "companyUrl": null,
 "advertiserId": "41508582",
 "location": "Melbourne VIC",
 "locationCountry": "AU",
 "locationState": null,
 "locationSuburb": null,
 "locationPostcode": null,
 "salaryText": null,
 "salaryMin": null
}

Filters that narrow a run

The input supports 53 options: query, country, location, startUrls, maxResults, maxPages, sortMode, dateRange, workType, workArrangement, classification, subClassification, salaryMin, salaryMax, includeKeywords, excludeKeywords, keywordMatchTitle, keywordMatchCompany, keywordMatchDescription, keywordMatchCategory, and more.

These filters run server-side. You pay for the records you request instead of retrieving a larger set and filtering it afterwards.

Coverage spans Australia and New Zealand. The country field accepts AU, NZ, defaulting to AU. Each run is scoped to one market before it produces a record, so data outside that market is neither fetched nor billed.

What it costs

Pricing is per event, with no subscription:

$0.01 per actor start
$0.002 per result

Here is a measured run, not an estimate:

25 records in 10.5 seconds
cost: $0.00073 — about $0.03 per 1,000 records

What people use it for

Benchmarking. Pricing and salary fields support comparisons across the full set instead of a page of results.
Reputation monitoring. Ratings and review text reveal movement over time that one page view cannot show.
Lead lists. Company-level fields help isolate the relevant segment before anyone opens a CRM.
Change detection. Timestamps make it possible to diff runs and act on new data instead of reading everything again.
Geographic analysis. Location fields allow market-by-market comparisons without another data source.

Limits

An empty field means the source showed nothing. Values are never inferred or filled from another source.
The schema follows Seek's markup, so a redesign can add, rename or drop fields.
Anything Seek puts behind a login is absent from every field below, by design.

Questions people ask

Are all fields always populated?

No. They are not guessed. When the source leaves a field blank, the field comes back blank. An empty value means Seek did not show one, not that extraction failed.

Which markets does it cover?

country accepts AU, NZ and defaults to AU. A run covers one market. Covering several requires several runs, and each run is billed only for what it returns.

Which filters are applied at the source?

maxResults, maxPages, dateRange, workType run server-side. This affects cost as well as convenience: filtered-out records are never produced, so they are never billed.

How fresh is the data?

Every run reads Seek when it runs, with no cached copy in between. Two runs a week apart produce two snapshots, making change detection possible.

Can I fetch only what changed?

Yes. incrementalMode exists for that. Without it, a re-run returns the full set again, and you dedupe on your side.

Is there an official Seek export?

No. There is no public bulk export or API. The field list above therefore comes from parsing pages, not from a documented schema.

Try it

If these are the fields you need, the Seek API endpoint we maintain produces them. New accounts receive $5 of free platform credit each month, enough to cover a real run of this size several times over.

Disclosure: we build and maintain this Actor, and the link above is an affiliate link.

DEV Community