Size local demand for a role before opening a staffing desk

Count how many employers are advertising a role in each metro before a staffing firm commits recruiters to a new desk or location.

Get a free API key + $5 Get a sample run

Free API key
No credit card
Run your sample

Uses POST /job_search/totals/, POST /job_search/ · Job postings API reference

What it costs: Charged per request: credit pricing.

How the data flows

3 inputs → Job postings API → 3 fields sample data

01 · Inputs

Title

Hiring Manager, Engineering

candidate metros

linkedin.com/in/sam-specimen

date range

linkedin.com/in/sam-specimen

02 · Forager

Job postings API POST /job_search/totals/

Match found

03 · Outputs

Sam SpecimenHiring Manager, Engineering · Example Inc.

name: Sam Specimen
title: Hiring Manager, Engineering
mobile: +1 (512) 555-0133
work email: sam@example.com
company: Example Inc.

3 fields in the responseexample data

Steps

Count postings for the role per metro with POST /job_search/totals/ (title, locations, date_featured_start, date_featured_end)
Repeat for the prior period to see whether demand is growing
List the employers behind the postings with POST /job_search/ (title, locations, is_active)
Rank metros by posting volume and employer count and share the shortlist with leadership

import json, os, requests

BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage"
HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]}
body = json.load(open("request.json"))  # request fields: see the API reference

# 1. Count postings for the role per metro with POST /job_search/totals/
# (title, locations, date_featured_start, date_featured_end)
r1 = requests.post(f"{BASE}/job_search/totals/", headers=HEADERS, json=body)

# 2. Repeat for the prior period to see whether demand is growing

# 3. List the employers behind the postings with POST /job_search/ (title,
# locations, is_active)
r2 = requests.post(f"{BASE}/job_search/", headers=HEADERS, json=body)

# 4. Rank metros by posting volume and employer count and share the
# shortlist with leadership

# 1. POST /job_search/totals/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/job_search/totals/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

# 2. POST /job_search/
curl -X POST \
  https://api-v2.forager.ai/api/{account_id}/datastorage/job_search/ \
  -H "X-API-KEY: $FORAGER_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Generated from the recipe stepsRequest fields: API reference

Run it yourself: Job postings API reference

Get a free API key + $5 Get a sample run

Free API key
No credit card
Run your sample

Inputs and outputs

Inputs	Outputs
role titles	`posting count per metro`
candidate metros	`period-over-period change`
date range	`employers posting the role`

Questions about this recipe

How can a staffing firm measure demand for a role in a city?

Count postings for the role per metro with POST /job_search/totals/ (title, locations, date_featured_start, date_featured_end). Repeat for the prior period to see whether demand is growing.

What does it cost to size local demand for a role before opening a staffing desk?

Job postings API: 2 credits per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 550 mobiles or 1,650 emails, or a mix. Self-serve plans are Starter, Growth, Pro and Scale. See plans and prices

What do I need to run this recipe, and what comes back?

You send candidate metros, date range and role titles. You get back employers posting the role, period-over-period change and posting count per metro, as JSON. You also need a Forager API key, which comes with a free account.

Which API counts job postings by title and location?

This recipe uses Forager Job postings API. Job postings API: Search live and historical job postings by company, title and location to spot hiring signals. Count how many employers are advertising a role in each metro before a staffing firm commits recruiters to a new desk or location.

Can I test the job postings API for free?

Yes. Create a free account at app.forager.ai: it comes with $5 in free credits and an API key, and there is no credit card to sign up. Run it on records you already know, or book a demo and send us a list: we run it and show you what we find.

When should I run this workflow?

When a staffing firm plans a new specialty desk, a new branch, or its quarterly territory review. Leadership opens desks where employer demand is visible in live postings, and recruiters start with a list of employers already hiring.

Which Forager products does this recipe use?

Job postings API. Job postings API: search live and historical job postings by company, title and location to spot hiring signals.

How do you check data quality?

The test that counts is your own: send a list of profiles you care about. We run it and show you what we find, number by number, so you can measure hit rate and connect rate yourself.

How many companies are hiring a role in a city?

Count postings for the role per metro with POST /job_search/totals/ (title, locations, date_featured_start, date_featured_end). Repeat for the prior period to see whether demand is growing.

Which tools can run this workflow?

Native in Clay, partner-built in Deepline and called through the API from your own code. Or call the endpoints in the steps above from your own code with one API key.

How many steps is this workflow?

4 steps: count postings for the role per metro with POST /job_search/totals/ (title, locations, date_featured_start, date_featured_end), repeat for the prior period to see whether demand is growing, list the employers behind the postings with POST /job_search/ (title, locations, is_active) and rank metros by posting volume and employer count and share the shortlist with leadership.

Do I need a subscription?

Not to test: a free account comes with $5 in credits. To keep using Forager, choose a monthly or yearly plan. Monthly plans cancel anytime and unused credits roll over; yearly plans grant all credits upfront and cost 10% less. Larger volumes are agreed with our team.

Size local demand for a role before opening a staffing desk

How the data flows

Steps

Inputs and outputs

Questions about this recipe

How can a staffing firm measure demand for a role in a city?

What does it cost to size local demand for a role before opening a staffing desk?

What do I need to run this recipe, and what comes back?

Which API counts job postings by title and location?

Can I test the job postings API for free?

When should I run this workflow?

Which Forager products does this recipe use?

How do you check data quality?

How many companies are hiring a role in a city?

Which tools can run this workflow?

How many steps is this workflow?

Do I need a subscription?

More recipes for staffing firms

Raise executive-search response rates with personal email and mobile

Win new staffing clients by reaching hiring leaders behind open roles

Source senior and specialist engineers for staff-augmentation placements

Re-engage past contractors when their assignment ends

Reveal candidate emails and mobiles in the browser for a boutique search firm

Contact a bench of temp candidates in one click via SMS and WhatsApp

Put people, company and job data your users can act on inside your product