Skip to main content
POST
/
api
/
v1
/
company
/
search
Company Search
curl --request POST \
  --url https://api.tuesday.so/api/v1/company/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "page": 123,
  "per_page": 123,
  "funding": "<string>",
  "extra": "<string>",
  "technology": "<string>",
  "website_traffic": "<string>",
  "headcount_growth": "<string>",
  "person_titles": [
    "<string>"
  ],
  "person_not_titles": [
    "<string>"
  ],
  "person_past_titles": [
    "<string>"
  ],
  "person_seniorities": [
    "<string>"
  ],
  "person_location": [
    "<string>"
  ],
  "not_person_location": [
    "<string>"
  ],
  "person_days_in_current_title_range": {},
  "q_organization_domains": [
    "<string>"
  ],
  "not_q_organization_domains": [
    "<string>"
  ],
  "organization_location": [
    "<string>"
  ],
  "not_organization_location": [
    "<string>"
  ],
  "organization_industry": [
    "<string>"
  ],
  "organization_not_industry": [
    "<string>"
  ],
  "organization_sic_industry": [
    "<string>"
  ],
  "organization_not_sic_industry": [
    "<string>"
  ],
  "organization_naics_industry": [
    "<string>"
  ],
  "organization_not_naics_industry": [
    "<string>"
  ],
  "organization_revenue_ranges": [
    "<string>"
  ],
  "organization_technology": [
    "<string>"
  ],
  "organization_all_technology": [
    "<string>"
  ],
  "not_organization_technology": [
    "<string>"
  ],
  "organization_has_web_app": true,
  "organization_has_mobile_app": true,
  "organization_appstore_app_category": [
    "<string>"
  ],
  "organization_playstore_app_category": [
    "<string>"
  ],
  "organization_appstore_rating": {},
  "organization_playstore_rating": {},
  "organization_appstore_review_count": {},
  "organization_playstore_review_count": {},
  "organization_is_website_for_sale": true,
  "organization_website_traffic_total_monthly": {},
  "organization_website_traffic_monthly_organic": {},
  "organization_website_traffic_monthly_paid": {},
  "organization_monthly_google_adspend": {},
  "organization_funding_amount": {},
  "organization_funding_total_amount": {},
  "organization_funding_date": {},
  "organization_funding_type": [
    "<string>"
  ],
  "organization_funding_lead_investors": [
    "<string>"
  ],
  "organization_funding_number_of_investors": {},
  "organization_roles_count": [
    {}
  ],
  "organization_open_roles_count": [
    {}
  ]
}'
{
    "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"
}

​
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

​
X-API-KEY
string
required
Your Tuesday API key

​
Request Parameters

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

​
📄 Pagination

​
page
int
default:"1"
Page number
​
per_page
int
default:"25"
Results per page (max: 100)
​
funding
string
default:"exclude"
Include funding detailsOptions: include | excludeAdditional Cost: +1 credit per result when set to include
​
extra
string
default:"exclude"
Include extended company detailsOptions: include | excludeAdditional Cost: +1 credit per result when set to include
​
technology
string
default:"exclude"
Include technology detailsOptions: include | excludeAdditional Cost: +2 credits per result when set to include
​
website_traffic
string
default:"exclude"
Include website traffic detailsOptions: include | excludeAdditional Cost: +1 credit per result when set to include
​
headcount_growth
string
default:"exclude"
Include headcount growth detailsOptions: include | excludeAdditional Cost: +1 credit per result when set to include

​
👤 Person Filters

​
person_titles
string[]
Current job titles to includeExamples: ["CEO", "CTO", "Software Engineer"]
​
person_not_titles
string[]
Exclude these current job titles
​
person_past_titles
string[]
Match against past job titles
​
person_seniorities
string[]
Filter by seniority levelExamples: ["C-Team", "Manager", "Director"]
​
person_location
string[]
Current person locationExamples: ["San Francisco", "California", "United States"]
​
not_person_location
string[]
Exclude people in these locations
​
person_days_in_current_title_range
object
Days in current role/titleFormat: {"min": 30, "max": 300}

​
🏢 Organization Filters

​
q_organization_domains
string[]
Match organization domainsExamples: ["google.com", "microsoft.com"]
​
not_q_organization_domains
string[]
Exclude organizations with these domains
​
organization_location
string[]
Company HQ/locationExamples: ["San Francisco", "California", "United States"]
​
not_organization_location
string[]
Exclude companies in these locations
​
organization_industry
string[]
Include companies in these industriesExamples: ["Technology", "Healthcare", "Finance"]
​
organization_not_industry
string[]
Exclude companies from these industries
​
organization_sic_industry
string[]
Filter by SIC codesExamples: ["0919"]
​
organization_not_sic_industry
string[]
Exclude SIC codes
​
organization_naics_industry
string[]
Filter by NAICS codesExamples: ["236117"]
​
organization_not_naics_industry
string[]
Exclude NAICS codes
​
organization_revenue_ranges
string[]
Revenue rangesExamples: ["<$1M", "$1M-$10M", "$10M-$50M"]

​
📱 Technology & Product Filters

​
organization_technology
string[]
Include if they use any of these toolsExamples: ["Salesforce", "AWS", "React"]
​
organization_all_technology
string[]
Must use all listed technologies
​
not_organization_technology
string[]
Exclude if using any of these technologies
​
organization_has_web_app
boolean
Has a web application?
​
organization_has_mobile_app
boolean
Has a mobile application?
​
organization_appstore_app_category
string[]
AppStore categoriesExamples: ["News", "Finance"]
​
organization_playstore_app_category
string[]
PlayStore categoriesExamples: ["Car race", "Games"]
​
organization_appstore_rating
object
iOS app rating (1–5)Format: {"min": 4, "max": 5}
​
organization_playstore_rating
object
Android app rating (1–5)Format: {"min": 4, "max": 5}
​
organization_appstore_review_count
object
Number of iOS reviewsFormat: {"min": 100, "max": 10000}
​
organization_playstore_review_count
object
Number of Android reviewsFormat: {"min": 100, "max": 10000}
​
organization_is_website_for_sale
boolean
Website listed for sale?

​
📈 Web Traffic & Ads

​
organization_website_traffic_total_monthly
object
Total monthly visitsFormat: {"min": 1000, "max": 100000}
​
organization_website_traffic_monthly_organic
object
Monthly organic trafficFormat: {"min": 1000, "max": 100000}
​
organization_website_traffic_monthly_paid
object
Monthly paid trafficFormat: {"min": 1000, "max": 100000}
​
organization_monthly_google_adspend
object
Estimated monthly Google Ads spend ($)Format: {"min": 1000, "max": 50000}

​
💰 Funding Filters

​
organization_funding_amount
object
Last round amountFormat: {"min": 1000000, "max": 100000000}
​
organization_funding_total_amount
object
Total raised fundingFormat: {"min": 1000000, "max": 100000000}
​
organization_funding_date
object
Months since last funding roundFormat: {"min": 1, "max": 24}
​
organization_funding_type
string[]
Funding stageExamples: ["Seed", "Series A", "Series B"]
​
organization_funding_lead_investors
string[]
Names of lead investors
​
organization_funding_number_of_investors
object
Number of investors in the last roundFormat: {"min": 1, "max": 10}

​
👨‍💼 Team & Roles

​
organization_roles_count
object[]
Role distribution by department & rangeFormat: [{"department": "android_dev", "range": {"min": 1, "max": 100}}]
​
organization_open_roles_count
object[]
Open roles per department with rangeFormat: [{"department": "sales", "range": {"min": 1, "max": 10}}]

​
Response

​
data
array
​
statusCode
number
HTTP status code (201 for success)
​
message
string
Response message

​
Example Requests

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"
}'

​
Example Response

{
    "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"
}

​
Search Strategies

Technology Sector:
# 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:
# 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
Investment Research:
# 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
Regional Analysis:
# 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

​
Credit Usage

Base per result
Funding/Extra/Web Traffic/Headcount per result
Technology per result
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

​
Advanced Filtering Combinations

// 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'
});

​
Pagination & Bulk Exports

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);

​
Use Cases

Sales Prospecting

Build targeted lists of companies matching your ideal customer profile

Market Research

Analyze market segments, competitor landscapes, and industry trends

Investment Pipeline

Identify investment opportunities across different funding stages

Competitive Intelligence

Monitor competitor activities and market positioning

Partnership Discovery

Find potential partners, vendors, and strategic alliances

Talent Acquisition

Identify companies for competitive hiring and talent mapping

​
Error Responses

{
    "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+"
}

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "At least one search filter is required"
}

​
Filter Reference

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
  • 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
  • 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
⌘I