> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryfundable.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search Companies > Look up companies using one of four search methods. Exactly one parameter must be provided. **Search types:** - `name` — Fuzzy name search with relevance scoring - `domain` — Company domain or full URL - `linkedin` — LinkedIn company URL - `crunchbase` — Crunchbase organization URL Examples: - `?linkedin=https://linkedin.com/company/stripe` - `?crunchbase=https://crunchbase.com/organization/notion` ## OpenAPI ````yaml openapi.json GET /company/search openapi: 3.0.3 info: title: Fundable API description: >- Canonical OpenAPI specification for the Fundable API. This file bundles the Deals, Companies, Investors, People, Alerts, Location, and Industry endpoints. version: 2.0.0 contact: name: Fundable API Support url: mailto:jacob@tryfundable.ai license: name: Proprietary url: https://www.tryfundable.ai/terms/privacy/ servers: - url: https://www.tryfundable.ai/api/v1 description: Production server security: - bearerAuth: [] tags: - name: deals description: Venture capital deals data - name: companies description: Company data, search, and discovery operations - name: investors description: Investor data and search operations - name: people description: People search and detail operations - name: alerts description: Saved alert configurations and deal data - name: locations description: Location search and utility operations - name: industries description: Industry and super category search operations paths: /company/search: get: summary: Search for a company by name, domain, LinkedIn, or Crunchbase description: > Look up companies using one of four search methods. Exactly one parameter must be provided. **Search types:** - `name` — Fuzzy name search with relevance scoring - `domain` — Company domain or full URL - `linkedin` — LinkedIn company URL - `crunchbase` — Crunchbase organization URL Examples: - `?linkedin=https://linkedin.com/company/stripe` - `?crunchbase=https://crunchbase.com/organization/notion` operationId: searchCompany parameters: - name: name in: query description: Fuzzy search by company name required: false schema: type: string example: stripe - name: domain in: query description: >- Company domain or full URL (e.g., "stripe.com" or "https://stripe.com") — URLs are automatically parsed to extract the domain required: false schema: type: string example: stripe.com - name: linkedin in: query description: LinkedIn company URL required: false schema: type: string example: https://linkedin.com/company/stripe - name: crunchbase in: query description: Crunchbase organization URL required: false schema: type: string example: https://crunchbase.com/organization/notion responses: '200': description: Successful search results content: application/json: schema: type: object properties: success: type: boolean example: true data: type: object properties: companies: type: array items: $ref: '#/components/schemas/CompanySearchResult' meta: type: object properties: total_count: type: integer description: Number of companies returned example: 1 page: type: integer example: 0 page_size: type: integer example: 1 credits_used: type: integer description: Number of credits consumed by this request example: 0 credit_source: type: string nullable: true enum: - monthly - purchased description: >- Source of credits used (only included for non-API tier keys) example: monthly monthly_credits_remaining: type: integer nullable: true description: >- Remaining monthly credits (only included for non-API tier keys) example: 990 purchased_credits_remaining: type: integer nullable: true description: >- Remaining purchased credits (only included for non-API tier keys) example: 500 required: - success - data - meta '400': description: Validation error (missing, multiple, or invalid parameters) content: application/json: schema: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string enum: - MISSING_SEARCH_PARAMS - MULTIPLE_SEARCH_PARAMS - EMPTY_SEARCH_TERM - INVALID_DOMAIN - INVALID_LINKEDIN_URL - INVALID_CRUNCHBASE_URL example: MULTIPLE_SEARCH_PARAMS message: type: string example: Only one search parameter is allowed at a time details: type: object properties: help: type: string example: >- You provided: name, domain. Please use only one of: name, domain, linkedin, or crunchbase '401': description: Authentication error content: application/json: schema: $ref: '#/components/schemas/AuthError' '402': description: Insufficient credits to complete request content: application/json: schema: $ref: '#/components/schemas/InsufficientCreditsError' '429': description: Rate limit exceeded (per-minute) content: application/json: schema: $ref: '#/components/schemas/RateLimitError' headers: Retry-After: description: Number of seconds to wait before retrying schema: type: integer example: 60 '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ServerError' components: schemas: CompanySearchResult: type: object properties: id: type: string format: uuid description: Unique identifier for the company example: 550e8400-e29b-41d4-a716-446655440000 guru_permalink: type: string nullable: true description: Fundable permalink for the company example: acme-corporation name: type: string description: Company name example: Acme Corporation short_description: type: string nullable: true description: Brief description of the company example: AI-powered solutions for modern enterprises relevance_score: type: number description: Search relevance score (0-1) example: 0.95 domain: type: string nullable: true description: Company website domain example: acme.com linkedin: type: string nullable: true description: LinkedIn profile URL crunchbase: type: string nullable: true description: Crunchbase profile URL AuthError: type: object properties: error: type: object properties: code: type: string enum: - AUTH_ERROR - INVALID_API_KEY - INACTIVE_API_KEY example: AUTH_ERROR message: type: string example: API key not provided details: type: object properties: help: type: string example: Please provide your API key in the Authorization header format: type: string example: Bearer vg_your_api_key_here required: - error InsufficientCreditsError: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: INSUFFICIENT_CREDITS message: type: string example: >- Not enough credits to complete this request. Visit https://www.tryfundable.ai/api-access to purchase more. details: type: object properties: credits_needed: type: integer nullable: true description: >- Number of credits required (included when known post-execution) example: 25 monthly_credits_remaining: type: integer description: Remaining monthly credits example: 0 purchased_credits_remaining: type: integer description: Remaining purchased credits example: 0 help: type: string example: >- Purchase additional credits at https://www.tryfundable.ai/api-access or upgrade your plan. required: - error RateLimitError: type: object properties: success: type: boolean example: false error: type: object properties: code: type: string example: RATE_LIMIT_EXCEEDED message: type: string example: Rate limit exceeded. Maximum 200 requests per minute. details: type: object properties: limit: type: integer description: Maximum requests allowed per window example: 200 window: type: string description: Rate limit window duration example: 60 seconds help: type: string example: Please reduce your request frequency and try again. required: - error ServerError: type: object properties: error: type: object properties: code: type: string example: INTERNAL_SERVER_ERROR message: type: string example: An unexpected error occurred details: type: string nullable: true description: Error details (only in development mode) required: - error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key provided as a Bearer token ````