Examples
Update Settings
Configure Crunchbase Companies Scraper settings
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/squids/{squid_hash}Configure your Crunchbase Companies Scraper squid settings.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredMust be application/json. Value: application/json
Squid Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| max_results | integer | — | Maximum number of companies collected per task. Leave empty to collect everything the task serves. A company URL always yields one company; a search serves at most 15 companies because Crunchbase gates pagination behind its paid plan. |
| industry | string | — | Only keep companies in these industries, e.g. Financial Services or Artificial Intelligence. Separate several with commas. Applies to search pages only. |
| location | string | — | Only keep companies based in these places, e.g. San Francisco, France or United States. Separate several with commas. Applies to search pages only. |
| founded_year_min | integer | — | Only collect companies founded in this year or later. Crunchbase keeps the founding date itself behind its paid plan, so it filters the search but never appears in the exported row. Search URLs only. |
| founded_year_max | integer | — | Only collect companies founded in this year or earlier. Same paywall caveat as founded_year_min. Search URLs only. |
| funding_stage | string | — | Only keep companies whose latest funding round is one of these stages. Comma separated for several (e.g. seed,series_a). One of: pre_seed, seed, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, series_i, series_j, series_unknown, private_equity, debt_financing, post_ipo_equity, secondary_market, non_equity_assistance, undisclosed. Search pages only. |
| employee_count | string | — | Only keep companies in one of these employee count ranges. Comma separated for several (e.g. 11-50,51-100). One of: 1-10, 11-50, 51-100, 101-250, 251-500, 501-1000, 1001-5000, 5001-10000, 10001+. Search pages only. |
| operating_status | string | — | Only collect companies that are still active, or only the ones Crunchbase marks as closed. Search URLs only. |
| company_type | string | — | Only collect for_profit companies or only non_profit organizations. Search URLs only. |
| ipo_status | string | — | Only collect public or private companies. Search URLs only. |
| company_details | boolean | false | Open every company found by a search to add its website, contacts, founders, investors, funding rounds, acquisitions, products and technology profile. Company URLs already include all of this at no extra cost. Costs 1 extra credit per company on a search. |
Code Examples
curl -X POST https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "industry": "Financial Services", "location": "San Francisco", "employee_count": "11-50", "funding_stage": "series_a", "company_details": true }'
Response
201
{"params": {"industry": "Financial Services", "location": "San Francisco", "employee_count": "11-50", "funding_stage": "series_a", "company_details": true}}