Skip to content

Organizations

Search the Forager organization index. Filter companies by attributes such as industry, headcount, location, keywords, and web technologies, and retrieve total match counts alongside the result set.

Operations

Organization search

Request

Organization search.

Security
Api-Key
Path
account_idintegerrequired
Body
pageinteger
organization_idsArray of integers

To get a list of IDs use Organizations lookup endpoint.

descriptionstring
locationsArray of integers

To get a list of IDs use Locations lookup endpoint.

industriesArray of integers

To get a list of IDs use Industries lookup endpoint.

industries_excludeArray of integers

To get a list of IDs use Industries lookup endpoint.

keywordsArray of integers

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

employees_startinteger
employees_endinteger
founded_date_startstring, (date)
founded_date_endstring, (date)
revenue_startinteger
revenue_endinteger
domainsArray of strings
domain_rank_startinteger
domain_rank_endinteger
domain_traffic_startinteger
domain_traffic_endinteger
web_technologiesArray of integers

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

linkedin_public_identifiersArray of strings

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

funding_typesArray of strings
funding_total_startinteger
funding_total_endinteger
job_post_titlestring

This field supports a boolean text search query.

job_post_descriptionstring

This field supports a boolean text search query.

job_post_is_remoteboolean or null
job_post_is_activeboolean or null
job_post_date_featured_startstring, (date)
job_post_date_featured_endstring, (date)
job_post_locationsArray of integers

To get a list of IDs use Locations lookup endpoint.

job_post_locations_excludeArray of integers

To get a list of IDs use Locations lookup endpoint.

simple_event_sourcestring(SimpleEventSourceEnum)
  • product_hunt - Product Hunt
  • form_c_sec_gov - Form C sec.gov
  • form_d_sec_gov - Form D sec.gov
Enum:"product_hunt""form_c_sec_gov""form_d_sec_gov"
simple_event_reasonstring(SimpleEventReasonEnum)
  • report_released - Report released
  • promoted_on_site - Promoted on site
Enum:"report_released""promoted_on_site"
curl -i -X POST \
  'https://api-v2.forager.ai/api/{account_id}/datastorage/organization_search/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "page": 0,
    "organization_ids": [
      0
    ],
    "description": "string",
    "locations": [
      0
    ],
    "industries": [
      0
    ],
    "industries_exclude": [
      0
    ],
    "keywords": [
      0
    ],
    "employees_start": 0,
    "employees_end": 0,
    "founded_date_start": "2019-08-24",
    "founded_date_end": "2019-08-24",
    "revenue_start": 0,
    "revenue_end": 0,
    "domains": [
      "string"
    ],
    "domain_rank_start": 0,
    "domain_rank_end": 0,
    "domain_traffic_start": 0,
    "domain_traffic_end": 0,
    "web_technologies": [
      0
    ],
    "linkedin_public_identifiers": [
      "string"
    ],
    "funding_types": [
      "angel"
    ],
    "funding_total_start": 0,
    "funding_total_end": 0,
    "funding_event_date_featured_start": "2019-08-24",
    "funding_event_date_featured_end": "2019-08-24",
    "job_post_title": "string",
    "job_post_description": "string",
    "job_post_is_remote": true,
    "job_post_is_active": true,
    "job_post_date_featured_start": "2019-08-24",
    "job_post_date_featured_end": "2019-08-24",
    "job_post_locations": [
      0
    ],
    "job_post_locations_exclude": [
      0
    ],
    "simple_event_source": "product_hunt",
    "simple_event_reason": "report_released",
    "simple_event_date_featured_start": "2019-08-24",
    "simple_event_date_featured_end": "2019-08-24"
  }'

Responses

Bodyapplication/json
search_resultsArray of objects(OrganizationSearchResult)read-onlyrequired
total_search_resultsinteger, >= 0required
Response
{
  "search_results": [
    { … }
  ],
  "total_search_results": 0
}