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

POST

api

company

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"]

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

Show Array of Company Objects

string

Unique identifier for the company

name

string

Company name

about_us

string

Company description

linkedin_url

string

LinkedIn company page URL

website_url

string

Primary website URL

primary_domain

string

Primary domain name

industry

string

Primary industry

specialties

string

Company specialities and focus areas (semicolon-separated)

founded_year

number

Year founded

employee_count_range

string

Employee count range (e.g., “11 to 50”)

employee_on_linkedin_growth_rate

number

LinkedIn employee growth rate (percentage)

city

string

Company city

state

string

Company state/region

country

string

Company country

country_code

string

ISO country code

country_region

string

Geographic region (NORAM, EMEA, APAC, LATAM)

headquarters.*

object

Headquarters location details (flattened)

phone

string

Company phone number

postcode

string

Postal code

street

string

Street address

revenue_range

string

Revenue range (e.g., “

1M to <

10M”)

has_cio

string

Has CIO position (“Yes”, “No”, “Unknown”)

has_ciso

string

Has CISO position (“Yes”, “No”, “Unknown”)

has_mobile_app

boolean

Has mobile application

has_web_app

boolean

Has web application

is_website_for_sale

boolean

Website listed for sale

is_linkedin_url_claimed

string

LinkedIn URL claimed status

location_continent

string

Continent location

location_count

number

Number of locations

valid_email_count

string

Number of valid email addresses

role_count.*

number

Role counts by department (flattened)

open_roles_count.*

number

Open role counts by department (flattened)

industry_details.*

string

Industry classification details (flattened)

technologies.*

string

Technology stack details (flattened)

website_traffic.*

number

Website traffic metrics (flattened)

appstore.*

string/number

App Store details (flattened)

playstore.*

string/number

Play Store details (flattened)

monthly_google_adspend

number

Monthly Google Ads spend

total_reviews

number

Total app reviews

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

Industry-Specific Searches

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

Funding-Based Searches

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

Geographic Searches

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

400 Bad Request - Invalid Parameters

400 Bad Request - No Search Criteria

Filter Reference

Industry Categories

Company Size Ranges

Funding Stages

Company Profile API - Get detailed information for specific companies
Company Employee Count - Get employee metrics for companies
Company Employee Search - Find employees within specific companies
People Search API - Search for people across companies

Company Employee Search

Authentication

People APIs

Company APIs

Company Search

Overview

Authentication

Request Parameters

👤 Person Filters

🏢 Organization Filters

📱 Technology & Product Filters

📈 Web Traffic & Ads

💰 Funding Filters

👨‍💼 Team & Roles

Response

Example Requests

Example Response

Search Strategies

Credit Usage

Advanced Filtering Combinations

Use Cases

Sales Prospecting

Market Research

Investment Pipeline

Competitive Intelligence

Partnership Discovery

Talent Acquisition

Error Responses

Filter Reference

Authentication

People APIs

Company APIs

​Overview

​Authentication

​Request Parameters

​📄 Pagination

​👤 Person Filters

​🏢 Organization Filters

​📱 Technology & Product Filters

​📈 Web Traffic & Ads

​💰 Funding Filters

​👨‍💼 Team & Roles

​Response

​Example Requests

​Example Response

​Search Strategies

​Credit Usage

​Advanced Filtering Combinations

​Pagination & Bulk Exports

​Use Cases

Sales Prospecting

Market Research

Investment Pipeline

Competitive Intelligence

Partnership Discovery

Talent Acquisition

​Error Responses

​Filter Reference

​Related Endpoints

Overview

Authentication

Request Parameters

📄 Pagination

👤 Person Filters

🏢 Organization Filters

📱 Technology & Product Filters

📈 Web Traffic & Ads

💰 Funding Filters

👨‍💼 Team & Roles

Response

Example Requests

Example Response

Search Strategies

Credit Usage

Advanced Filtering Combinations

Pagination & Bulk Exports

Use Cases

Error Responses

Filter Reference

Related Endpoints