Skip to main content
POST
Organization search totals

When to use this endpoint

You want to know how many companies a company search would return before paging through results. The totals endpoint takes the same body as the search and returns only the count, so count first and page only through the matches you need.

Example request

cURL
Set FORAGER_API_KEY and FORAGER_ACCOUNT_ID as in the quickstart.

Example response

200 (illustrative values)

Credits

The credit cost of this operation is not documented yet. See API credits and pricing.

Authorizations

X-API-KEY
string
header
required

Path Parameters

account_id
integer
required

Body

Organization search request serializer.

page
integer
organization_ids
integer[]

To get a list of IDs use Organizations lookup endpoint.

description
string
locations
integer[]

To get a list of IDs use Locations lookup endpoint.

industries
integer[]

To get a list of IDs use Industries lookup endpoint.

industries_exclude
integer[]

To get a list of IDs use Industries lookup endpoint.

keywords
integer[]

To get a list of IDs use Organization keywords lookup endpoint.

employees_start
integer
employees_end
integer
founded_date_start
string<date>
founded_date_end
string<date>
revenue_start
integer
revenue_end
integer
domains
string[]
domain_rank_start
integer
domain_rank_end
integer
domain_traffic_start
integer
domain_traffic_end
integer
web_technologies
integer[]

To get a list of IDs use Web technologies lookup endpoint.

linkedin_public_identifiers
string[]

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/company/!slug!/".

funding_types
enum<string>[]
  • angel - Angel
  • convertible_note - Convertible Note
  • corporate_round - Corporate Round
  • debt_financing - Debt Financing
  • equity_crowdfunding - Equity Crowdfunding
  • grant - Grant
  • initial_coin_offering - Initial coin offering (ICO)
  • non_equity_assistance - Non-Equity Assistance
  • post_ipo_debt - Post-IPO Debt
  • post_ipo_equity - Post-IPO Equity
  • post_ipo_secondary - Post-IPO Secondary
  • pre_seed - Pre-Seed
  • private_equity - Private Equity
  • product_crowdfunding - Product Crowdfunding
  • secondary_market - Secondary Market
  • seed - Seed
  • series_a - Series A
  • series_b - Series B
  • series_c - Series C
  • series_d - Series D
  • series_e - Series E
  • series_f - Series F
  • series_g - Series G
  • series_h - Series H
  • series_i - Series I
  • series_j - Series J
  • series_unknown - Venture - Series Unknown
  • undisclosed - Undisclosed
Available options:
angel,
convertible_note,
corporate_round,
debt_financing,
equity_crowdfunding,
grant,
initial_coin_offering,
non_equity_assistance,
post_ipo_debt,
post_ipo_equity,
post_ipo_secondary,
pre_seed,
private_equity,
product_crowdfunding,
secondary_market,
seed,
series_a,
series_b,
series_c,
series_d,
series_e,
series_f,
series_g,
series_h,
series_i,
series_j,
series_unknown,
undisclosed
funding_total_start
integer
funding_total_end
integer
job_post_title
string

This field supports a boolean text search query.

job_post_description
string

This field supports a boolean text search query.

job_post_is_remote
boolean | null
job_post_is_active
boolean | null
job_post_date_featured_start
string<date>
job_post_date_featured_end
string<date>
job_post_locations
integer[]

To get a list of IDs use Locations lookup endpoint.

job_post_locations_exclude
integer[]

To get a list of IDs use Locations lookup endpoint.

simple_event_source
enum<string>
  • product_hunt - Product Hunt
  • form_c_sec_gov - Form C sec.gov
  • form_d_sec_gov - Form D sec.gov
Available options:
product_hunt,
form_c_sec_gov,
form_d_sec_gov
simple_event_reason
enum<string>
  • report_released - Report released
  • promoted_on_site - Promoted on site
Available options:
report_released,
promoted_on_site

Response

Organization search totals response serializer.

total_search_results
integer
required
Required range: x >= 0
Last modified on November 1, 2026