> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuesday.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Search

> Search across organizational records using a rich set of filters

## Overview

Search for companies using advanced filters including industry, size, location, funding stage, technology, and growth metrics. Perfect for prospecting, market research, competitive analysis, and building targeted company lists.

## Authentication

<ParamField header="X-API-KEY" type="string" required>
  Your Tuesday API key
</ParamField>

## Request Parameters

All parameters are optional. Combine them to filter results precisely.

### 📄 Pagination

<ParamField body="page" type="int" default="1">
  Page number
</ParamField>

<ParamField body="per_page" type="int" default="25">
  Results per page (max: 100)
</ParamField>

<ParamField body="funding" type="string" default="exclude">
  Include funding details

  **Options:** `include` | `exclude`

  **Additional Cost:** +1 credit per result when set to `include`
</ParamField>

<ParamField body="extra" type="string" default="exclude">
  Include extended company details

  **Options:** `include` | `exclude`

  **Additional Cost:** +1 credit per result when set to `include`
</ParamField>

<ParamField body="technology" type="string" default="exclude">
  Include technology details

  **Options:** `include` | `exclude`

  **Additional Cost:** +2 credits per result when set to `include`
</ParamField>

<ParamField body="website_traffic" type="string" default="exclude">
  Include website traffic details

  **Options:** `include` | `exclude`

  **Additional Cost:** +1 credit per result when set to `include`
</ParamField>

<ParamField body="headcount_growth" type="string" default="exclude">
  Include headcount growth details

  **Options:** `include` | `exclude`

  **Additional Cost:** +1 credit per result when set to `include`
</ParamField>

### 👤 Person Filters

<ParamField body="person_titles" type="string[]">
  Current job titles to include

  **Examples:** `["CEO", "CTO", "Software Engineer"]`
</ParamField>

<ParamField body="person_not_titles" type="string[]">
  Exclude these current job titles
</ParamField>

<ParamField body="person_past_titles" type="string[]">
  Match against past job titles
</ParamField>

<ParamField body="person_seniorities" type="string[]">
  Filter by seniority level

  **Examples:** `["C-Team", "Manager", "Director"]`
</ParamField>

<ParamField body="person_location" type="string[]">
  Current person location

  **Examples:** `["San Francisco", "California", "United States"]`
</ParamField>

<ParamField body="not_person_location" type="string[]">
  Exclude people in these locations
</ParamField>

<ParamField body="person_days_in_current_title_range" type="object">
  Days in current role/title

  **Format:** `{"min": 30, "max": 300}`
</ParamField>

### 🏢 Organization Filters

<ParamField body="q_organization_domains" type="string[]">
  Match organization domains

  **Examples:** `["google.com", "microsoft.com"]`
</ParamField>

<ParamField body="not_q_organization_domains" type="string[]">
  Exclude organizations with these domains
</ParamField>

<ParamField body="organization_location" type="string[]">
  Company HQ/location

  **Examples:** `["San Francisco", "California", "United States"]`
</ParamField>

<ParamField body="not_organization_location" type="string[]">
  Exclude companies in these locations
</ParamField>

<ParamField body="organization_industry" type="string[]">
  Include companies in these industries

  **Examples:** `["Technology", "Healthcare", "Finance"]`
</ParamField>

<ParamField body="organization_not_industry" type="string[]">
  Exclude companies from these industries
</ParamField>

<ParamField body="organization_sic_industry" type="string[]">
  Filter by SIC codes

  **Examples:** `["0919"]`
</ParamField>

<ParamField body="organization_not_sic_industry" type="string[]">
  Exclude SIC codes
</ParamField>

<ParamField body="organization_naics_industry" type="string[]">
  Filter by NAICS codes

  **Examples:** `["236117"]`
</ParamField>

<ParamField body="organization_not_naics_industry" type="string[]">
  Exclude NAICS codes
</ParamField>

<ParamField body="organization_revenue_ranges" type="string[]">
  Revenue ranges

  **Examples:** `["<$1M", "$1M-$10M", "$10M-$50M"]`
</ParamField>

### 📱 Technology & Product Filters

<ParamField body="organization_technology" type="string[]">
  Include if they use any of these tools

  **Examples:** `["Salesforce", "AWS", "React"]`
</ParamField>

<ParamField body="organization_all_technology" type="string[]">
  Must use all listed technologies
</ParamField>

<ParamField body="not_organization_technology" type="string[]">
  Exclude if using any of these technologies
</ParamField>

<ParamField body="organization_has_web_app" type="boolean">
  Has a web application?
</ParamField>

<ParamField body="organization_has_mobile_app" type="boolean">
  Has a mobile application?
</ParamField>

<ParamField body="organization_appstore_app_category" type="string[]">
  AppStore categories

  **Examples:** `["News", "Finance"]`
</ParamField>

<ParamField body="organization_playstore_app_category" type="string[]">
  PlayStore categories

  **Examples:** `["Car race", "Games"]`
</ParamField>

<ParamField body="organization_appstore_rating" type="object">
  iOS app rating (1–5)

  **Format:** `{"min": 4, "max": 5}`
</ParamField>

<ParamField body="organization_playstore_rating" type="object">
  Android app rating (1–5)

  **Format:** `{"min": 4, "max": 5}`
</ParamField>

<ParamField body="organization_appstore_review_count" type="object">
  Number of iOS reviews

  **Format:** `{"min": 100, "max": 10000}`
</ParamField>

<ParamField body="organization_playstore_review_count" type="object">
  Number of Android reviews

  **Format:** `{"min": 100, "max": 10000}`
</ParamField>

<ParamField body="organization_is_website_for_sale" type="boolean">
  Website listed for sale?
</ParamField>

### 📈 Web Traffic & Ads

<ParamField body="organization_website_traffic_total_monthly" type="object">
  Total monthly visits

  **Format:** `{"min": 1000, "max": 100000}`
</ParamField>

<ParamField body="organization_website_traffic_monthly_organic" type="object">
  Monthly organic traffic

  **Format:** `{"min": 1000, "max": 100000}`
</ParamField>

<ParamField body="organization_website_traffic_monthly_paid" type="object">
  Monthly paid traffic

  **Format:** `{"min": 1000, "max": 100000}`
</ParamField>

<ParamField body="organization_monthly_google_adspend" type="object">
  Estimated monthly Google Ads spend (\$)

  **Format:** `{"min": 1000, "max": 50000}`
</ParamField>

### 💰 Funding Filters

<ParamField body="organization_funding_amount" type="object">
  Last round amount

  **Format:** `{"min": 1000000, "max": 100000000}`
</ParamField>

<ParamField body="organization_funding_total_amount" type="object">
  Total raised funding

  **Format:** `{"min": 1000000, "max": 100000000}`
</ParamField>

<ParamField body="organization_funding_date" type="object">
  Months since last funding round

  **Format:** `{"min": 1, "max": 24}`
</ParamField>

<ParamField body="organization_funding_type" type="string[]">
  Funding stage

  **Examples:** `["Seed", "Series A", "Series B"]`
</ParamField>

<ParamField body="organization_funding_lead_investors" type="string[]">
  Names of lead investors
</ParamField>

<ParamField body="organization_funding_number_of_investors" type="object">
  Number of investors in the last round

  **Format:** `{"min": 1, "max": 10}`
</ParamField>

### 👨‍💼 Team & Roles

<ParamField body="organization_roles_count" type="object[]">
  Role distribution by department & range

  **Format:** `[{"department": "android_dev", "range": {"min": 1, "max": 100}}]`
</ParamField>

<ParamField body="organization_open_roles_count" type="object[]">
  Open roles per department with range

  **Format:** `[{"department": "sales", "range": {"min": 1, "max": 10}}]`
</ParamField>

## Response

<ResponseField name="data" type="array">
  <Expandable title="Array of Company Objects">
    <ResponseField name="id" type="string">
      Unique identifier for the company
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name
    </ResponseField>

    <ResponseField name="about_us" type="string">
      Company description
    </ResponseField>

    <ResponseField name="linkedin_url" type="string">
      LinkedIn company page URL
    </ResponseField>

    <ResponseField name="website_url" type="string">
      Primary website URL
    </ResponseField>

    <ResponseField name="primary_domain" type="string">
      Primary domain name
    </ResponseField>

    <ResponseField name="industry" type="string">
      Primary industry
    </ResponseField>

    <ResponseField name="specialties" type="string">
      Company specialities and focus areas (semicolon-separated)
    </ResponseField>

    <ResponseField name="founded_year" type="number">
      Year founded
    </ResponseField>

    <ResponseField name="employee_count_range" type="string">
      Employee count range (e.g., "11 to 50")
    </ResponseField>

    <ResponseField name="employee_on_linkedin_growth_rate" type="number">
      LinkedIn employee growth rate (percentage)
    </ResponseField>

    <ResponseField name="city" type="string">
      Company city
    </ResponseField>

    <ResponseField name="state" type="string">
      Company state/region
    </ResponseField>

    <ResponseField name="country" type="string">
      Company country
    </ResponseField>

    <ResponseField name="country_code" type="string">
      ISO country code
    </ResponseField>

    <ResponseField name="country_region" type="string">
      Geographic region (NORAM, EMEA, APAC, LATAM)
    </ResponseField>

    <ResponseField name="headquarters.*" type="object">
      Headquarters location details (flattened)
    </ResponseField>

    <ResponseField name="phone" type="string">
      Company phone number
    </ResponseField>

    <ResponseField name="postcode" type="string">
      Postal code
    </ResponseField>

    <ResponseField name="street" type="string">
      Street address
    </ResponseField>

    <ResponseField name="revenue_range" type="string">
      Revenue range (e.g., "$1M to <$10M")
    </ResponseField>

    <ResponseField name="has_cio" type="string">
      Has CIO position ("Yes", "No", "Unknown")
    </ResponseField>

    <ResponseField name="has_ciso" type="string">
      Has CISO position ("Yes", "No", "Unknown")
    </ResponseField>

    <ResponseField name="has_mobile_app" type="boolean">
      Has mobile application
    </ResponseField>

    <ResponseField name="has_web_app" type="boolean">
      Has web application
    </ResponseField>

    <ResponseField name="is_website_for_sale" type="boolean">
      Website listed for sale
    </ResponseField>

    <ResponseField name="is_linkedin_url_claimed" type="string">
      LinkedIn URL claimed status
    </ResponseField>

    <ResponseField name="location_continent" type="string">
      Continent location
    </ResponseField>

    <ResponseField name="location_count" type="number">
      Number of locations
    </ResponseField>

    <ResponseField name="valid_email_count" type="string">
      Number of valid email addresses
    </ResponseField>

    <ResponseField name="role_count.*" type="number">
      Role counts by department (flattened)
    </ResponseField>

    <ResponseField name="open_roles_count.*" type="number">
      Open role counts by department (flattened)
    </ResponseField>

    <ResponseField name="industry_details.*" type="string">
      Industry classification details (flattened)
    </ResponseField>

    <ResponseField name="technologies.*" type="string">
      Technology stack details (flattened)
    </ResponseField>

    <ResponseField name="website_traffic.*" type="number">
      Website traffic metrics (flattened)
    </ResponseField>

    <ResponseField name="appstore.*" type="string/number">
      App Store details (flattened)
    </ResponseField>

    <ResponseField name="playstore.*" type="string/number">
      Play Store details (flattened)
    </ResponseField>

    <ResponseField name="monthly_google_adspend" type="number">
      Monthly Google Ads spend
    </ResponseField>

    <ResponseField name="total_reviews" type="number">
      Total app reviews
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="statusCode" type="number">
  HTTP status code (201 for success)
</ResponseField>

<ResponseField name="message" type="string">
  Response message
</ResponseField>

## Example Requests

<CodeGroup>
  ```bash Basic Company Search theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/search' \
  --header 'X-API-KEY: your-api-key-here' \
  --header 'Content-Type: application/json' \
  --data '{
      "page": 1,
      "per_page": 25,
      "person_titles": ["Software Engineer"],
      "funding": "include",
      "technology": "include",
      "website_traffic": "include",
      "headcount_growth": "include",
      "extra": "include"
  }'
  ```

  ```bash Funded E-commerce Companies theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/search' \
  --header 'X-API-KEY: your-api-key-here' \
  --header 'Content-Type: application/json' \
  --data '{
      "page": 1,
      "per_page": 25,
      "organization_industry": ["E-commerce"],
      "organization_funding_type": ["Series A"],
      "funding": "include"
  }'
  ```

  ```bash Large Tech Companies theme={null}
  curl --location 'https://api.tuesday.so/api/v1/company/search' \
  --header 'X-API-KEY: your-api-key-here' \
  --header 'Content-Type: application/json' \
  --data '{
      "page": 1,
      "per_page": 25,
      "organization_industry": ["Technology"],
      "organization_location": ["United States"],
      "extra": "include"
  }'
  ```

  ```javascript JavaScript theme={null}
  const searchCompanies = async (payload) => {
    const response = await fetch(
      'https://api.tuesday.so/api/v1/company/search',
      {
        method: 'POST',
        headers: {
          'X-API-KEY': 'your-api-key-here',
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(payload)
      }
    );

    const results = await response.json();
    return results;
  };

  // Usage Examples
  const techStartups = await searchCompanies({
    page: 1,
    per_page: 25,
    organization_industry: ['Technology'],
    person_titles: ['Software Engineer'],
    funding: 'include',
    technology: 'include'
  });

  const aiCompanies = await searchCompanies({
    page: 1,
    per_page: 25,
    organization_technology: ['artificial intelligence'],
    organization_funding_type: ['Series A'],
    funding: 'include'
  });

  const ecommerceScale = await searchCompanies({
    page: 1,
    per_page: 25,
    organization_industry: ['E-commerce'],
    organization_technology: ['Shopify'],
    extra: 'include'
  });

  console.log(`Found ${techStartups.data.length} tech startups`);
  ```

  ```python Python theme={null}
  import requests

  def search_companies(payload):
      url = "https://api.tuesday.so/api/v1/company/search"
      headers = {
          'X-API-KEY': 'your-api-key-here',
          'Content-Type': 'application/json'
      }
      
      response = requests.post(url, json=payload, headers=headers)
      return response.json()

  # Usage Examples
  # Find SaaS companies in growth stage
  saas_companies = search_companies({
      "page": 1,
      "per_page": 25,
      "organization_industry": ["SaaS"],
      "person_titles": ["Software Engineer"],
      "funding": "include",
      "technology": "include"
  })

  # Find well-funded AI startups
  ai_startups = search_companies({
      "page": 1,
      "per_page": 25,
      "organization_technology": ["artificial intelligence", "machine learning"],
      "organization_funding_type": ["Series B"],
      "funding": "include"
  })

  # Find tech companies using specific technology
  react_companies = search_companies({
      "page": 1,
      "per_page": 25,
      "organization_technology": ["React"],
      "organization_industry": ["Technology"],
      "organization_location": ["California"],
      "technology": "include"
  })

  for company in saas_companies['data']:
      print(f"{company['name']} - {company.get('employee_count_range', 'N/A')} employees")
      print(f"Founded: {company.get('founded_year', 'N/A')} | Industry: {company.get('industry', 'N/A')}")
      print("---")
  ```

  ```php PHP theme={null}
  <?php
  function searchCompanies($payload) {
      $ch = curl_init();
      curl_setopt($ch, CURLOPT_URL, "https://api.tuesday.so/api/v1/company/search");
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
      curl_setopt($ch, CURLOPT_POST, true);
      curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
      curl_setopt($ch, CURLOPT_HTTPHEADER, [
          'X-API-KEY: your-api-key-here',
          'Content-Type: application/json'
      ]);
      
      $response = curl_exec($ch);
      curl_close($ch);
      
      return json_decode($response, true);
  }

  // Usage Examples
  $fintechStartups = searchCompanies([
      'page' => 1,
      'per_page' => 25,
      'organization_industry' => ['Fintech'],
      'person_titles' => ['Software Engineer'],
      'funding' => 'include',
      'technology' => 'include'
  ]);

  $techGiants = searchCompanies([
      'page' => 1,
      'per_page' => 25,
      'organization_industry' => ['Technology'],
      'organization_location' => ['United States'],
      'extra' => 'include'
  ]);

  foreach ($fintechStartups['data'] as $company) {
      echo $company['name'] . " - " . $company['about_us'] . "\n";
      echo "Employees: " . $company['employee_count_range'] . "\n";
      echo "Founded: " . $company['founded_year'] . "\n\n";
  }
  ?>
  ```
</CodeGroup>

## Example Response

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "about_us": "Welcome to the official page of Cartão de TODOS on LinkedIn! We are pioneers in the country, with a successful and established business model, serving over 5 million families in all Brazilian states.",
              "appstore.app_category": "Finance",
              "appstore.last_update": "2024-01-11",
              "appstore.top_rating": 4.9,
              "appstore.top_review_count": 32935,
              "appstore.top_url": "https://apps.apple.com/br/app/id1536693230",
              "appstore.update_count": 25,
              "city": "Ipatinga",
              "country": "Brazil",
              "country_code": "BR",
              "country_region": "LATAM",
              "employee_count_range": "5001 to 10000",
              "employee_on_linkedin_growth_rate": 3,
              "has_cio": "Unknown",
              "has_ciso": "Unknown",
              "has_mobile_app": true,
              "has_web_app": false,
              "headquarters.city": "Ipatinga",
              "headquarters.country_name": "Brazil",
              "headquarters.state": "Minas Gerais",
              "id": "tu_oacdlz2wb",
              "industry": "Wellness and Fitness Services",
              "industry_details.naics_code": "541611;541512;459999",
              "industry_details.naics_description": "Administrative Management and General Management Consulting Services;Computer Systems Design Services;All Other Miscellaneous Retailers",
              "is_linkedin_url_claimed": "true",
              "is_website_for_sale": false,
              "linkedin_url": "https://www.linkedin.com/company/cartao-de-todos",
              "location_continent": "South America",
              "location_count": 1,
              "name": "Cartão De Todos",
              "playstore.app_category": "Finance",
              "playstore.download_count": 5028400,
              "playstore.last_update": "2024-01-09",
              "playstore.top_rating": 3,
              "playstore.top_review_count": 399303,
              "playstore.top_url": "https://play.google.com/store/apps/details?id=com.cartaodetodoswalletapp",
              "postcode": "35162-399",
              "primary_domain": "cartaodetodos.com.br",
              "role_count.business_development": 1,
              "role_count.engineer": 1,
              "role_count.it": 27,
              "role_count.marketing": 45,
              "role_count.sales": 3,
              "specialties": "clínica médica;serviços;saúde;odontologia;educação a distância;lazer;descontos",
              "state": "Minas Gerais",
              "street": "37 Rua Dom Pedro Ii",
              "technologies.automation": "Hubspot",
              "technologies.cloud_provider": "Microsoft Azure",
              "technologies.cms": "Hubspot",
              "technologies.crm": "Hubspot",
              "technologies.email_hosting": "Microsoft",
              "total_reviews": 432238,
              "website_traffic.monthly_organic": 94,
              "website_traffic.total_monthly": 94,
              "website_url": "https://cartaodetodos.com.br"
          },
          {
              "about_us": "Seal Distributors Inc is a company specializing in the Fluid Sealing industry and is located at 200 Tech Dr, Sanford, Florida, United States.",
              "city": "Sanford",
              "country": "United States",
              "country_code": "US",
              "country_region": "NORAM",
              "employee_count_range": "11 to 50",
              "founded_year": 1985,
              "has_cio": "Unknown",
              "has_ciso": "Unknown",
              "has_mobile_app": false,
              "has_web_app": false,
              "headquarters.city": "Sanford",
              "headquarters.country_name": "United States",
              "headquarters.state": "Florida",
              "id": "tu_oab7ugt2z",
              "industry": "Wholesale",
              "industry_details.naics_code": "423840;339991;325520",
              "industry_details.naics_description": "Industrial Supplies Merchant Wholesalers;Gasket; Packing; and Sealing Device Manufacturing;Adhesive Manufacturing",
              "is_linkedin_url_claimed": "true",
              "is_website_for_sale": false,
              "linkedin_url": "https://www.linkedin.com/company/seal-distributors-inc",
              "location_continent": "North America",
              "location_count": 1,
              "name": "Seal Distributors Inc",
              "phone": "+1 800-334-1711",
              "postcode": "32771-6662",
              "primary_domain": "sealdistributors.com",
              "revenue_range": "$1M to <$10M",
              "role_count.sales": 3,
              "state": "Florida",
              "street": "200 Tech Dr",
              "valid_email_count": "5",
              "website_traffic.monthly_organic": 163,
              "website_traffic.total_monthly": 163,
              "website_url": "https://www.sealdistributors.com"
          }
      ],
      "statusCode": 201,
      "message": "Success"
  }
  ```
</ResponseExample>

## Search Strategies

<AccordionGroup>
  <Accordion title="Industry-Specific Searches">
    **Technology Sector:**

    ```bash theme={null}
    # AI/ML companies
    ?keywords=artificial intelligence machine learning&industry=Technology&founded_year_min=2018

    # SaaS platforms
    ?industry=SaaS&revenue_range=10M-50M&growth_stage=Scale-up

    # Cybersecurity firms
    ?keywords=cybersecurity security&company_size=51-200&has_funding=true
    ```

    **Healthcare & Life Sciences:**

    ```bash theme={null}
    # Digital health startups
    ?industry=Healthcare&keywords=digital health&founded_year_min=2019&funding_stage=Series A

    # Biotech companies
    ?industry=Biotechnology&revenue_range=1M-10M&location=Boston
    ```
  </Accordion>

  <Accordion title="Funding-Based Searches">
    **Investment Research:**

    ```bash theme={null}
    # Recently funded startups
    ?funding_stage=Series A&founded_year_min=2022&sort_by=funding_amount

    # High-growth companies
    ?has_funding=true&growth_stage=Scale-up&employee_count_min=100

    # Pre-IPO companies
    ?funding_stage=Series D+&company_size=1001-5000&type=Private
    ```
  </Accordion>

  <Accordion title="Geographic Searches">
    **Regional Analysis:**

    ```bash theme={null}
    # Silicon Valley tech scene
    ?location=San Francisco&industry=Technology&company_size=51-200

    # European fintech
    ?industry=Fintech&country=UK,Germany,France&has_funding=true

    # Emerging markets
    ?country=India,Brazil,Singapore&growth_stage=Startup&founded_year_min=2020
    ```
  </Accordion>
</AccordionGroup>

## Credit Usage

<div className="grid grid-cols-1 md:grid-cols-3 gap-4 my-6">
  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-blue-600">
      {1}
    </div>

    <div className="text-sm text-gray-600">Base per result</div>
  </div>

  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-orange-600">
      {"+1"}
    </div>

    <div className="text-sm text-gray-600">Funding/Extra/Web Traffic/Headcount per result</div>
  </div>

  <div className="border rounded-lg p-4 text-center">
    <div className="text-2xl font-bold text-red-600">
      {"+2"}
    </div>

    <div className="text-sm text-gray-600">Technology per result</div>
  </div>
</div>

<Warning>
  **Cost Calculation Example:**

  * Search returning 20 results with all enrichments enabled
  * Base cost: 20 × 1 = 20 credits
  * Funding enrichment: 20 × 1 = 20 credits
  * Technology enrichment: 20 × 2 = 40 credits
  * Extra enrichment: 20 × 1 = 20 credits
  * Website traffic enrichment: 20 × 1 = 20 credits
  * Headcount growth enrichment: 20 × 1 = 20 credits
  * **Total: 140 credits**
</Warning>

## Advanced Filtering Combinations

<CodeGroup>
  ```javascript Market Research Queries theme={null}
  // Find competitors in specific segments
  const ecommerceCompetitors = await searchCompanies({
    industry: 'E-commerce',
    company_size: '201-500',
    technology: 'Shopify',
    revenue_range: '10M-50M',
    country: 'US'
  });

  // Identify acquisition targets
  const acquisitionTargets = await searchCompanies({
    industry: 'SaaS',
    company_size: '11-50',
    founded_year_min: 2018,
    has_funding: true,
    growth_stage: 'Growth',
    limit: 50
  });

  // Find companies using specific technology
  const reactCompanies = await searchCompanies({
    technology: 'React',
    industry: 'Technology',
    company_size: '51-200',
    location: 'California',
    sort_by: 'employee_count'
  });
  ```

  ```python Investment Pipeline theme={null}
  def find_investment_opportunities():
      # Early stage startups with traction
      early_stage = search_companies(
          funding_stage='Seed',
          founded_year_min=2021,
          growth_stage='Startup',
          has_funding=True,
          industry='Technology',
          limit=100
      )
      
      # Growth companies ready for Series B
      growth_stage = search_companies(
          funding_stage='Series A',
          company_size='51-200',
          growth_stage='Scale-up',
          founded_year_max=2020,
          sort_by='funding_amount'
      )
      
      # Pre-IPO opportunities
      pre_ipo = search_companies(
          funding_stage='Series D+',
          company_size='1001-5000',
          revenue_range='100M-500M',
          type='Private'
      )
      
      return {
          'early_stage': early_stage['data'],
          'growth_stage': growth_stage['data'], 
          'pre_ipo': pre_ipo['data']
      }
  ```
</CodeGroup>

## Pagination & Bulk Exports

<CodeGroup>
  ```javascript Complete Market Export theme={null}
  async function exportMarketSegment(filters, maxResults = 5000) {
    let allCompanies = [];
    let offset = 0;
    const batchSize = 100;
    
    while (allCompanies.length < maxResults) {
      const params = new URLSearchParams({
        ...filters,
        limit: Math.min(batchSize, maxResults - allCompanies.length),
        offset: offset
      });
      
      const response = await fetch(
        `https://api.tuesday.so/api/v1/company/search?${params}`,
        { headers: { 'X-API-KEY': 'your-api-key-here' } }
      );
      
      const data = await response.json();
      
      if (!data.data || data.data.length === 0) break;
      
      allCompanies.push(...data.data);
      
      if (!data.pagination.has_more) break;
      
      offset += batchSize;
      
      // Rate limiting pause
      await new Promise(resolve => setTimeout(resolve, 3000));
    }
    
    return allCompanies.slice(0, maxResults);
  }

  // Export all SaaS companies in California
  const californiaSaas = await exportMarketSegment({
    industry: 'SaaS',
    location: 'California',
    company_size: '51-200,201-500',
    has_funding: true
  }, 2000);
  ```
</CodeGroup>

## Use Cases

<CardGroup cols={2}>
  <Card title="Sales Prospecting" icon="bullseye">
    Build targeted lists of companies matching your ideal customer profile
  </Card>

  <Card title="Market Research" icon="chart-bar">
    Analyze market segments, competitor landscapes, and industry trends
  </Card>

  <Card title="Investment Pipeline" icon="chart-line">
    Identify investment opportunities across different funding stages
  </Card>

  <Card title="Competitive Intelligence" icon="chess-knight">
    Monitor competitor activities and market positioning
  </Card>

  <Card title="Partnership Discovery" icon="handshake">
    Find potential partners, vendors, and strategic alliances
  </Card>

  <Card title="Talent Acquisition" icon="users">
    Identify companies for competitive hiring and talent mapping
  </Card>
</CardGroup>

## Error Responses

<AccordionGroup>
  <Accordion title="400 Bad Request - Invalid Parameters">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request",
        "error": "Invalid company_size value. Must be one of: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001+"
    }
    ```
  </Accordion>

  <Accordion title="400 Bad Request - No Search Criteria">
    ```json theme={null}
    {
        "statusCode": 400,
        "message": "Bad Request",
        "error": "At least one search filter is required"
    }
    ```
  </Accordion>
</AccordionGroup>

## Filter Reference

<AccordionGroup>
  <Accordion title="Industry Categories">
    **Popular Industries:**

    * Technology, Software, SaaS, AI/ML
    * Healthcare, Biotechnology, Pharmaceuticals
    * Fintech, Banking, Insurance
    * E-commerce, Retail, Consumer Goods
    * Manufacturing, Automotive, Energy
    * Media, Entertainment, Gaming
    * Real Estate, Construction
    * Education, Non-profit
  </Accordion>

  <Accordion title="Company Size Ranges">
    * `1-10`: Micro companies and very early startups
    * `11-50`: Small companies and startups
    * `51-200`: Small to medium companies
    * `201-500`: Medium companies
    * `501-1000`: Medium-large companies
    * `1001-5000`: Large companies
    * `5001+`: Enterprise and Fortune 500 companies
  </Accordion>

  <Accordion title="Funding Stages">
    * `Pre-Seed`: Very early funding before Seed
    * `Seed`: Initial formal funding round
    * `Series A`: First major VC round
    * `Series B`: Growth funding round
    * `Series C`: Later-stage growth funding
    * `Series D+`: Late-stage private funding
    * `IPO`: Public companies
    * `Acquired`: Companies that have been acquired
  </Accordion>
</AccordionGroup>

## Related Endpoints

* [Company Profile API](/api-reference/company/profile) - Get detailed information for specific companies
* [Company Employee Count](/api-reference/company/employee-count) - Get employee metrics for companies
* [Company Employee Search](/api-reference/company/employee-search) - Find employees within specific companies
* [People Search API](/api-reference/people/search) - Search for people across companies