{"openapi":"3.1.0","info":{"title":"Crunchbase (BYOK) API","version":"0.1.0","description":"Crunchbase (BYOK) lets an AI assistant read your own Crunchbase data through the Crunchbase API with a key you supply (Crunchbase API key). Read-only: 7 tools (autocomplete_entities, get_organization, get_organization_card, get_person, get_funding_round, get_acquisition, search_organizations_by_domain). The BYOK key travels with each request, is used for that one call only and is never stored,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-crunchbase.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-crunchbase/docs"},"termsOfService":"https://connectorbay.com/byok-crunchbase/terms"},"servers":[{"url":"https://byok-crunchbase.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-crunchbase/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/autocomplete_entities":{"post":{"operationId":"autocomplete_entities","summary":"Find Crunchbase entities (organizations, people, categories, locations and others) whose name matches a text, to get the","description":"Find Crunchbase entities (organizations, people, categories, locations and others) whose name matches a text, to get their permalink or UUID. Up to 25 matches. Use for \"Find the Crunchbase permalink for Stripe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Text to match against entity names.","maxLength":100,"title":"Query","type":"string"},"collection_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated collections to search, for example organizations,people (default: all).","title":"Collection Ids"},"limit":{"anyOf":[{"maximum":25,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Number of results (1 to 25, default 10).","title":"Limit"}},"required":["query"],"title":"autocomplete_entitiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_organization":{"post":{"operationId":"get_organization","summary":"Get one company by permalink or UUID: description, website, founding date, status, size, funding totals, categories and ","description":"Get one company by permalink or UUID: description, website, founding date, status, size, funding totals, categories and locations, plus optional cards such as founders, investors or raised funding rounds. Available fields depend on the key's data package. Use for \"Give me the Crunchbase profile of stripe, including founders\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"entity_id":{"description":"Organization permalink (for example 'stripe') or UUID.","maxLength":100,"title":"Entity Id","type":"string"},"field_ids":{"anyOf":[{"maxLength":600,"type":"string"},{"type":"null"}],"default":"name,short_description,website_url,founded_on,operating_status,company_type,num_employees_enum,funding_total,last_funding_type,last_funding_at,num_funding_rounds,ipo_status,categories,location_identifiers,linkedin,twitter,rank_org","description":"Comma-separated Crunchbase organization field ids to return (for example name, short_description). Default: a summary set.","title":"Field Ids"},"card_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated cards to include, such as founders, investors, raised_funding_rounds, headquarters_address, jobs (for example founders,investors). Cards can be large; omit for none.","title":"Card Ids"}},"required":["entity_id"],"title":"get_organizationArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_organization_card":{"post":{"operationId":"get_organization_card","summary":"Page through one card of a company (founders, investors, raised_funding_rounds, jobs, child_organizations and others), u","description":"Page through one card of a company (founders, investors, raised_funding_rounds, jobs, child_organizations and others), up to 100 rows per page. Use for \"List the investors of stripe on Crunchbase\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"entity_id":{"description":"Organization permalink (for example 'stripe') or UUID.","maxLength":100,"title":"Entity Id","type":"string"},"card_id":{"description":"Card name: acquiree_acquisitions, acquirer_acquisitions, child_organizations, child_ownerships, event_appearances, founders, headquarters_address, investors, ipos, jobs, parent_organization, parent_ownership, participated_funding_rounds, participated_funds, participated_investments, press_references, raised_funding_rounds, raised_funds or raised_investments.","enum":["acquiree_acquisitions","acquirer_acquisitions","child_organizations","child_ownerships","event_appearances","founders","headquarters_address","investors","ipos","jobs","parent_organization","parent_ownership","participated_funding_rounds","participated_funds","participated_investments","press_references","raised_funding_rounds","raised_funds","raised_investments"],"title":"Card Id","type":"string"},"after_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"UUID of the last item of the previous page, to fetch the next page.","title":"After Id"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Rows per page (1 to 100, default 100).","title":"Limit"}},"required":["entity_id","card_id"],"title":"get_organization_cardArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_person":{"post":{"operationId":"get_person","summary":"Get one person by permalink or UUID: name, title, primary organization, social links, counts of jobs, investments and ex","description":"Get one person by permalink or UUID: name, title, primary organization, social links, counts of jobs, investments and exits, plus optional cards (jobs, founded_organizations, degrees and others). Use for \"Give me the Crunchbase profile of patrick-collison\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"entity_id":{"description":"Person permalink (for example 'patrick-collison') or UUID.","maxLength":100,"title":"Entity Id","type":"string"},"field_ids":{"anyOf":[{"maxLength":600,"type":"string"},{"type":"null"}],"default":"name,short_description,primary_job_title,primary_organization,location_identifiers,linkedin,twitter,num_founded_organizations,num_investments,num_exits,rank_person","description":"Comma-separated Crunchbase person field ids to return (for example name, short_description). Default: a summary set.","title":"Field Ids"},"card_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated cards to include, such as jobs, founded_organizations, degrees, primary_job, participated_investments (for example jobs,founded_organizations). Cards can be large; omit for none.","title":"Card Ids"}},"required":["entity_id"],"title":"get_personArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_funding_round":{"post":{"operationId":"get_funding_round","summary":"Get one funding round by permalink or UUID: announcement date, investment type, money raised, valuation, number of inves","description":"Get one funding round by permalink or UUID: announcement date, investment type, money raised, valuation, number of investors and the funded organization. Use for \"Show the details of a Crunchbase funding round\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"entity_id":{"description":"Funding round permalink (for example 'stripe-series-a--7e2cd5c2') or UUID.","maxLength":120,"title":"Entity Id","type":"string"},"field_ids":{"anyOf":[{"maxLength":600,"type":"string"},{"type":"null"}],"default":"identifier,announced_on,investment_type,money_raised,post_money_valuation,pre_money_valuation,num_investors,lead_investor_identifiers,funded_organization_identifier","description":"Comma-separated Crunchbase funding round field ids to return (for example identifier, announced_on). Default: a summary set.","title":"Field Ids"},"card_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated cards to include, such as investments, investors, lead_investors, organization (for example investors,organization). Cards can be large; omit for none.","title":"Card Ids"}},"required":["entity_id"],"title":"get_funding_roundArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_acquisition":{"post":{"operationId":"get_acquisition","summary":"Get one acquisition by permalink or UUID: acquirer, acquiree, announcement and completion dates, price, type and status.","description":"Get one acquisition by permalink or UUID: acquirer, acquiree, announcement and completion dates, price, type and status. Use for \"Show the details of a Crunchbase acquisition record\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"entity_id":{"description":"Acquisition permalink or UUID.","maxLength":120,"title":"Entity Id","type":"string"},"field_ids":{"anyOf":[{"maxLength":600,"type":"string"},{"type":"null"}],"default":"identifier,acquirer_identifier,acquiree_identifier,announced_on,completed_on,price,acquisition_type,status,short_description","description":"Comma-separated Crunchbase acquisition field ids to return (for example identifier, acquirer_identifier). Default: a summary set.","title":"Field Ids"},"card_ids":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated cards to include, such as acquirer_organization, acquiree_organization, press_references (for example acquirer_organization,acquiree_organization). Cards can be large; omit for none.","title":"Card Ids"}},"required":["entity_id"],"title":"get_acquisitionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_organizations_by_domain":{"post":{"operationId":"search_organizations_by_domain","summary":"Find companies by website domain (domain_eq match on website_url) and return a summary of each: name, description, fundi","description":"Find companies by website domain (domain_eq match on website_url) and return a summary of each: name, description, funding, status and locations. Use for \"Which Crunchbase company has the domain stripe.com\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"domain":{"description":"Website domain without scheme, for example 'stripe.com'.","maxLength":100,"title":"Domain","type":"string"},"limit":{"anyOf":[{"maximum":25,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum results (1 to 25).","title":"Limit"}},"required":["domain"],"title":"search_organizations_by_domainArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}