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 details

Options: include | exclude

Additional Cost: +1 credit per result when set to include

​
extra
string
default:"exclude"

Include extended company details

Options: include | exclude

Additional Cost: +1 credit per result when set to include

​
technology
string
default:"exclude"

Include technology details

Options: include | exclude

Additional Cost: +2 credits per result when set to include

​
website_traffic
string
default:"exclude"

Include website traffic details

Options: include | exclude

Additional Cost: +1 credit per result when set to include

​
headcount_growth
string
default:"exclude"

Include headcount growth details

Options: include | exclude

Additional Cost: +1 credit per result when set to include

​
👤 Person Filters

​
person_titles
string[]

Current job titles to include

Examples: ["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 level

Examples: ["C-Team", "Manager", "Director"]

​
person_location
string[]

Current person location

Examples: ["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/title

Format: {"min": 30, "max": 300}

​
🏢 Organization Filters

​
q_organization_domains
string[]

Match organization domains

Examples: ["google.com", "microsoft.com"]

​
not_q_organization_domains
string[]

Exclude organizations with these domains

​
organization_location
string[]

Company HQ/location

Examples: ["San Francisco", "California", "United States"]

​
not_organization_location
string[]

Exclude companies in these locations

​
organization_industry
string[]

Include companies in these industries

Examples: ["Technology", "Healthcare", "Finance"]

​
organization_not_industry
string[]

Exclude companies from these industries

​
organization_sic_industry
string[]

Filter by SIC codes

Examples: ["0919"]

​
organization_not_sic_industry
string[]

Exclude SIC codes

​
organization_naics_industry
string[]

Filter by NAICS codes

Examples: ["236117"]

​
organization_not_naics_industry
string[]

Exclude NAICS codes

​
organization_revenue_ranges
string[]

Revenue ranges

Examples: ["<$1M", "$1M-$10M", "$10M-$50M"]

​
📱 Technology & Product Filters

​
organization_technology
string[]

Include if they use any of these tools

Examples: ["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 categories

Examples: ["News", "Finance"]

​
organization_playstore_app_category
string[]

PlayStore categories

Examples: ["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 reviews

Format: {"min": 100, "max": 10000}

​
organization_playstore_review_count
object

Number of Android reviews

Format: {"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 visits

Format: {"min": 1000, "max": 100000}

​
organization_website_traffic_monthly_organic
object

Monthly organic traffic

Format: {"min": 1000, "max": 100000}

​
organization_website_traffic_monthly_paid
object

Monthly paid traffic

Format: {"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 amount

Format: {"min": 1000000, "max": 100000000}

​
organization_funding_total_amount
object

Total raised funding

Format: {"min": 1000000, "max": 100000000}

​
organization_funding_date
object

Months since last funding round

Format: {"min": 1, "max": 24}

​
organization_funding_type
string[]

Funding stage

Examples: ["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 round

Format: {"min": 1, "max": 10}

​
👨‍💼 Team & Roles

​
organization_roles_count
object[]

Role distribution by department & range

Format: [{"department": "android_dev", "range": {"min": 1, "max": 100}}]

​
organization_open_roles_count
object[]

Open roles per department with range

Format: [{"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

​
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

​
Filter Reference