/crunchbase/db/search

POST /api/crunchbase/db/search

Price: 1 credit

Search Crunchbase companies in dataset (fast)

How to use it

Search Crunchbase companies from dataset by filters.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• keywords union — Description keywords. Example: 'FinTech' or ['RegTech', 'FinTech'] (default: []; examples: "FinTech")
• location union — HQ locations. Example: 'Boston' or ['San Francisco', 'Boston'] (default: []; examples: "San Francisco")
• industry union — Industries. Example: 'SaaS' or ['SaaS', 'Cloud Computing'] (default: []; examples: "SaaS")
• employee_count_min integer nullable — Min employee count. Allowed: 1, 11, 51, 101, 251, 501, 1001, 5001, 10001 (one of: 1, 11, 51, 101, 251, 501, 1001, 5001, 10001; examples: 11)
• employee_count_max integer nullable — Max employee count. Allowed: 10, 50, 100, 250, 500, 1000, 5000, 10000, 10001 (one of: 10, 50, 100, 250, 500, 1000, 5000, 10000, 10001; examples: 500)
• founded_after integer nullable — Founded after date as Unix timestamp. Example: 1577836800 (examples: 1577836800)
• founded_before integer nullable — Founded before date as Unix timestamp. Example: 1703980800 (examples: 1703980800)
• last_funding_date_after integer nullable — Last funding date after as Unix timestamp. Example: 1672531200 (examples: 1672531200)
• last_funding_date_before integer nullable — Last funding date before as Unix timestamp. Example: 1735603200 (examples: 1735603200)
• last_funding_type union — Last funding round type(s) (default: []; examples: "series_a")
• funding_total_min integer nullable — Min total funding raised in USD. Example: 5000000 (examples: 5000000; min: 0)
• funding_total_max integer nullable — Max total funding raised in USD. Example: 200000000 (examples: 200000000; min: 0)
• investors union — Investor names. Example: 'Sequoia Capital' or ['Sequoia Capital', 'Andreessen Horowitz'] (default: []; examples: "Sequoia Capital")
• count integer required — Max result count. A `dry_run` request ignores it. (max: 100; >: 0)
• dry_run boolean — Return how many companies match these filters instead of the companies. The response is a 209 with an empty body and the number in the headers, so a filter set can be sized before it is run for real. It stops at 100000 — a wider filter set reports exactly that and means 'at least'. (default: false)

Response

• @type string (default: "CrunchbaseCompany")
• id string required (format: uuid)
• name string required
• alias string required
• url string required
• logo_url string nullable
• short_description string required
• description string required
• legal_name string nullable
• website string nullable
• founded_on string nullable
• operating_status string nullable
• company_type string nullable
• ipo_status string nullable
• employee_count_range string nullable
• revenue_range string nullable
• categories array (default: [])
• location object nullable
  • @type string (default: "CrunchbaseLocation")
  • city string nullable
  • region string nullable
  • country string nullable
  • country_code string nullable
  • continent string nullable
  • groups array (default: [])
• contacts object nullable
  • @type string (default: "CrunchbaseContacts")
  • email string nullable
  • phone string nullable
  • facebook_url string nullable
  • linkedin_url string nullable
  • twitter_url string nullable
  • num_contacts integer nullable
  • num_contact_emails integer nullable
  • num_contact_phones integer nullable
• funding object nullable
  • @type string (default: "CrunchbaseFunding")
  • stock_symbol string nullable
  • total_usd integer nullable
  • num_rounds integer nullable
  • last_type string nullable
  • last_at string nullable
  • num_investors integer nullable
  • num_lead_investors integer nullable
  • num_lead_investments integer nullable
• metrics object nullable
  • @type string (default: "CrunchbaseMetrics")
  • cb_rank integer nullable
  • rank_delta number nullable
  • num_investments integer nullable
  • num_acquisitions integer nullable
  • num_exits integer nullable
  • num_current_positions integer nullable
  • num_sub_organizations integer nullable
  • num_current_advisor_positions integer nullable
  • heat_score integer nullable
  • heat_score_delta integer nullable
  • growth_score integer nullable
  • growth_score_delta integer nullable
  • semrush_global_rank integer nullable
  • semrush_visits_latest_month integer nullable
  • semrush_visits_mom_pct number nullable
  • semrush_bounce_rate number nullable
  • semrush_visit_duration integer nullable
  • semrush_visit_pageviews number nullable
  • builtwith_num_technologies integer nullable
  • siftery_num_products integer nullable
  • aberdeen_it_spend_usd integer nullable
• ipo object nullable
  • @type string (default: "CrunchbaseIPO")
  • went_public_on string nullable
  • share_price_usd integer nullable
  • amount_raised_usd integer nullable
  • valuation_usd integer nullable
• patents object nullable
  • @type string (default: "CrunchbasePatents")
  • num_patents_granted integer nullable
  • num_trademarks_registered integer nullable
  • popular_patent_category string nullable
  • popular_trademark_class string nullable
• acquired_by object nullable
  • @type string (default: "CrunchbaseAcquiredBy")
  • name string required
  • alias string nullable
  • announced_on string nullable
  • acquisition_type string nullable
• related object nullable
  • @type string (default: "CrunchbaseRelated")
  • aliases array (default: [])
  • founders array (default: [])
  • investors array (default: [])
  • competitors array (default: [])
• leadership_hires array (default: [])
  • @type string (default: "CrunchbaseLeadershipHire")
  • date string nullable
  • description string nullable
  • press_title string nullable
  • press_url string nullable
  • press_publisher string nullable
• siftery_products array (default: [])
  • @type string (default: "CrunchbaseSifteryProduct")
  • name string required
  • status string nullable
  • num_customers integer nullable
• bombora_surges array (default: [])
  • @type string (default: "CrunchbaseBomboraSurge")
  • topic string required
  • category string nullable
  • surge_score integer nullable
  • surge_wow_growth number nullable
  • weeks_surging integer nullable
• apptopia object nullable
  • @type string (default: "CrunchbaseApptopia")
  • total_apps integer nullable
  • total_downloads integer nullable
  • apps array (default: [])
    • @type string (default: "CrunchbaseApptopiaApp")
    • name string required
    • stores array (default: [])
    • monthly_downloads integer nullable
• predictions object nullable
  • @type string (default: "CrunchbasePredictions")
  • growth_score number nullable
  • growth_tier string nullable
  • funding_score number nullable
  • funding_tier string nullable
  • acquisition_score number nullable
  • acquisition_tier string nullable
  • ipo_score number nullable
  • ipo_tier string nullable
  • ipo_media_sentiment string nullable
• technologies array (default: [])
  • @type string (default: "CrunchbaseTechnology")
  • name string required
  • categories array (default: [])
  • num_companies_using integer nullable
• employees array (default: [])
  • @type string (default: "CrunchbaseEmployee")
  • name string required
  • alias string nullable
  • started_on string nullable
• investors array (default: [])
  • @type string (default: "CrunchbaseInvestor")
  • name string required
  • alias string nullable
  • type string nullable
  • round string nullable
• products array (default: [])
  • @type string (default: "CrunchbaseProduct")
  • name string required
  • description string nullable
• acquisitions array (default: [])
  • @type string (default: "CrunchbaseAcquisition")
  • name string required
  • announced_on string nullable
• funding_rounds array (default: [])
  • @type string (default: "CrunchbaseFundingRound")
  • name string required
  • announced_on string nullable
  • investment_type string nullable
  • money_raised_usd integer nullable
  • num_investors integer nullable
  • lead_investors array (default: [])
• investments array (default: [])
  • @type string (default: "CrunchbaseInvestment")
  • company string required
  • round_name string nullable
  • announced_on string nullable
  • is_lead boolean (default: false)
  • money_raised_usd integer nullable
• layoffs array (default: [])
  • @type string (default: "CrunchbaseLayoff")
  • date string nullable
  • description string nullable
• awards array (default: [])
  • @type string (default: "CrunchbaseAward")
  • name string required
  • date string nullable
  • description string nullable
• offices array (default: [])
  • @type string (default: "CrunchbaseOffice")
  • name string nullable
  • opening_date string nullable
  • description string nullable
• news array (default: [])
  • @type string (default: "CrunchbaseNews")
  • url string nullable
  • publisher string nullable
  • date string nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.