EnrichedNow documentation
Scrapers behind one API.
Pick a scraper, send its input, get structured records back. Every scraper is started the same way and answers with the same kind of result — including a plain statement when it could not read something.
One request starts a run
The answer is a run with a status, a count of records and what it cost. The records are one more request away.
curl -X POST "https://api.enrichednow.com/v1/scrapers/ats.board/runs?wait=60" \
-H "Authorization: Bearer $ENRICHEDNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": {"board_url": "https://boards.greenhouse.io/acme"}}'Guides
- QuickstartA key, a run and its records, in three requests.
- Running a scraperwait, polling, paging through records, cancelling.
- Results and statusesEvery status and reason code, and what to do about each.
- Usage and unitsWhat a run costs, and when it costs nothing.
- ErrorsThe error shape, the codes, which ones to retry.
- API referenceEvery endpoint of version 1.
Scrapers available today
- ats.boardATS job boardJob openings from one board of an applicant tracking system (Greenhouse, Lever, Ashby, Workday and others).
- careers.companyCompany careers siteJob openings from a company's own careers site: give its domain or its careers page.
- linkedin.companyLinkedIn company pageA company's public LinkedIn profile: website, industry, size, headquarters and more. Give its page address or slug.
- linkedin.jobLinkedIn job postingOne LinkedIn job posting's public details: give its address or its id.
- linkedin.jobs_searchLinkedIn job searchJob postings from LinkedIn's public job search: keywords, a place, and how recently they were listed.
- web.crawlWebsite to MarkdownCrawl a public website from a start page and read its pages as clean Markdown, obeying robots.txt.
- web.fetchWeb pageFetch one public web page: give its address, get the status, headers and body the server sent.
- web.markdownWeb page to MarkdownRead one public web page as clean Markdown, with its title, description, links and metadata.
- youtube.channel_videosYouTube channel videosThe latest videos on a YouTube channel's Videos tab (the first page, up to 30), newest first.
- youtube.searchYouTube searchSearch YouTube: the videos, Shorts, channels and playlists on the first page of results for a query.
- youtube.videoYouTube videoOne YouTube video from its address or id: title, description, channel, dates, length, views, likes, tags and caption languages.
- walmart.productWalmart productOne Walmart product's details: price, availability, seller, rating, specifications, images and variants.
- walmart.searchWalmart searchThe products on a page of Walmart's search results: prices, ratings, sellers, with advertisements marked.
- app_store.appApp Store appOne app's page on Apple's App Store for a country: developer, category, rating, price, description, version and images.
- google_play.appGoogle Play appOne app's Google Play listing: developer, category, rating, installs, price, description, last update and images.
Five ways a run can end
A run always says what happened. You pay for runs that returned a result, and not for the ones that could not.
- ok
- The target was read. Charged.
- partial
- Records, with a known gap. Charged.
- failed
- The target could not be read. Free.
- unsupported
- It needs something we do not do yet. Free.
- cancelled
- You stopped it. Free.