Return firmographics and open roles from a domain in a web data API

Let a web data or scraping API answer a company lookup with structured firmographics and open roles, instead of scraping and parsing the company's site on every call.

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

Free API key
No credit card
Run your sample

Uses POST /organization_search/, POST /job_search/totals/ · Company enrichment API reference

What it costs: Charged per request: credit pricing.

How the data flows

One input → Company enrichment + Job postings API → 5 fields sample data

01 · Inputs

Company domain

example.com

02 · Forager

Company enrichment + Job postings API POST /organization_search/

Match found

03 · Outputs

Sam SpecimenVP Revenue Operations · Example Inc.

industry: Software
employees range: 120
founded date: true
location: Austin, TX
open roles count: VP Revenue Operations
name: Sam Specimen

5 fields in the responseexample data

Steps

Call POST /organization_search/ (domains) and map name, industry, employees_range, founded_date, location and keywords
Call POST /job_search/totals/ (organization_ids, is_active) to add an open-roles count
Return both as one typed response and cache it against the domain
Fall back to the scraper only when no organization matches

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. Call POST /organization_search/ (domains) and map name, industry,
# employees_range, founded_date, location and keywords
r1 = requests.post(f"{BASE}/organization_search/", headers=HEADERS, json=body)

# 2. Call POST /job_search/totals/ (organization_ids, is_active) to add an
# open-roles count
r2 = requests.post(f"{BASE}/job_search/totals/", headers=HEADERS, json=body)

# 3. Return both as one typed response and cache it against the domain

# 4. Fall back to the scraper only when no organization matches

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

# 2. 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

Generated from the recipe stepsRequest fields: API reference

Run it yourself: Company enrichment 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
company domain	`industry`
	`employees_range`
	`founded_date`
	`location`
	`open roles count`

Questions about this recipe

Which API returns structured company data from a domain?

This recipe uses Forager Company enrichment and Job postings API. Company enrichment: Firmographics for a company from its domain or name: industry, headcount, locations, growth and open roles. Let a web data or scraping API answer a company lookup with structured firmographics and open roles, instead of scraping and parsing the company's site on every call.

What does it cost to return firmographics and open roles from a domain in a web data API?

Company enrichment: 1 credit per request, charged whether or not data comes back. Job postings API: 2 credits per request, charged whether or not data comes back. Growth's 8,250 monthly credits cover 8,250 company lookups, 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 company domain. You get back employees_range, founded_date, industry and location, as JSON. You also need a Forager API key, which comes with a free account.

How can a scraping API add firmographics without scraping company sites?

Call POST /organization_search/ (domains) and map name, industry, employees_range, founded_date, location and keywords. Call POST /job_search/totals/ (organization_ids, is_active) to add an open-roles count.

Can I test company enrichment 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 developer calls the web data API's company endpoint with a domain. Developers get a stable, typed company record from one call, and the provider spends less on scraping and parsing.

Which Forager products does this recipe use?

Company enrichment and job postings API. Company enrichment: firmographics for a company from its domain or name: industry, headcount, locations, growth and open roles. 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.

Which tools can run this workflow?

Native in Clay, partner-built in Deepline and Cargo and called through the API from Make, n8n and 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: call POST /organization_search/ (domains) and map name, industry, employees_range, founded_date, location and keywords, call POST /job_search/totals/ (organization_ids, is_active) to add an open-roles count, return both as one typed response and cache it against the domain and fall back to the scraper only when no organization matches.

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.

Can our users see Forager data in our product?

Yes, under platform terms. Self-serve plans cover internal use by your own team. Showing Forager data to your users, or passing records on, is licensed separately: talk to sales about volume and which fields your users need to see.

Return firmographics and open roles from a domain in a web data API

How the data flows

Steps

Inputs and outputs

Questions about this recipe

Which API returns structured company data from a domain?

What does it cost to return firmographics and open roles from a domain in a web data API?

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

How can a scraping API add firmographics without scraping company sites?

Can I test company enrichment for free?

When should I run this workflow?

Which Forager products does this recipe use?

How do you check data quality?

Which tools can run this workflow?

How many steps is this workflow?

Do I need a subscription?

Can our users see Forager data in our product?

More recipes for web data APIs

Offer mobile and email enrichment as native actions in a GTM workflow builder

Convert personal-email sign-ups into work identities

Score accounts on hiring momentum from job postings

Qualify PLG sign-ups and route enterprise accounts to sales

Build verified ICP lists for done-for-you cold email campaigns

Enrich leads before an AI agent writes personalized campaign copy

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