Get Company Profile

curl --request GET \
  --url https://api.tuesday.so/api/v1/company/profile \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://api.tuesday.so/api/v1/company/profile"

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://api.tuesday.so/api/v1/company/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tuesday.so/api/v1/company/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tuesday.so/api/v1/company/profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.tuesday.so/api/v1/company/profile")
  .header("X-API-KEY", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tuesday.so/api/v1/company/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
    "data": {
        "id": "tu_cmp_sf2023",
        "name": "Salesforce",
        "linkedin_url": "https://www.linkedin.com/company/salesforce",
        "website_url": "https://www.salesforce.com",
        "primary_domain": "salesforce.com",
        "domains": [
            "salesforce.com",
            "force.com",
            "trailhead.com",
            "tableau.com"
        ],
        "description": "Salesforce is the global leader in Customer Relationship Management (CRM), bringing companies and customers together in the digital age.",
        "industry": "Computer Software",
        "industries": [
            "Computer Software",
            "Cloud Computing",
            "CRM Software"
        ],
        "specialities": [
            "CRM",
            "Cloud Computing",
            "Mobile",
            "Social",
            "Platform",
            "App Development",
            "Analytics"
        ],
        "founded_year": 1999,
        "company_size": "10001+",
        "employee_count": 79390,
        "headquarters": {
            "address": "415 Mission Street, 3rd Floor",
            "city": "San Francisco",
            "state": "California",
            "country": "United States",
            "postal_code": "94105"
        },
        "locations": [
            {
                "city": "San Francisco",
                "state": "California",
                "country": "United States",
                "is_headquarters": true
            },
            {
                "city": "New York",
                "state": "New York", 
                "country": "United States",
                "is_headquarters": false
            }
        ],
        "phone": "+1-415-901-7000",
        "logo_url": "https://logo.clearbit.com/salesforce.com",
        "stock_symbol": "CRM",
        "type": "Public",
        "annual_revenue": {
            "amount": 31352000000,
            "currency": "USD",
            "year": 2023
        },
        "funding": {
            "total_funding": 1700000000,
            "last_funding_round": {
                "type": "IPO",
                "amount": 110000000,
                "date": "2004-06-23",
                "valuation": 1100000000
            },
            "funding_rounds": [
                {
                    "type": "Series A",
                    "amount": 4000000,
                    "date": "1999-12-01"
                }
            ],
            "investors": [
                "Kleiner Perkins",
                "Oracle Corporation"
            ]
        },
        "technology": {
            "categories": [
                "Customer Support",
                "CRM",
                "Analytics",
                "Marketing Automation"
            ],
            "tools": [
                "Slack",
                "Tableau",
                "MuleSoft",
                "Heroku"
            ],
            "integrations": [
                "Microsoft Office 365",
                "Google Workspace",
                "AWS"
            ]
        },
        "contacts": [
            {
                "name": "Marc Benioff",
                "title": "Chairman & CEO",
                "linkedin_url": "https://www.linkedin.com/in/marcbenioff",
                "email": "marc@salesforce.com"
            },
            {
                "name": "Amy Weaver",
                "title": "President & CFO",
                "linkedin_url": "https://www.linkedin.com/in/amy-weaver-salesforce",
                "email": "aweaver@salesforce.com"
            }
        ]
    },
    "statusCode": 200,
    "message": "Success"
}

GET

api

company

profile

Get Company Profile

curl --request GET \
  --url https://api.tuesday.so/api/v1/company/profile \
  --header 'X-API-KEY: <x-api-key>'

import requests

url = "https://api.tuesday.so/api/v1/company/profile"

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-KEY': '<x-api-key>'}};

fetch('https://api.tuesday.so/api/v1/company/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tuesday.so/api/v1/company/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tuesday.so/api/v1/company/profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.tuesday.so/api/v1/company/profile")
  .header("X-API-KEY", "<x-api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tuesday.so/api/v1/company/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
    "data": {
        "id": "tu_cmp_sf2023",
        "name": "Salesforce",
        "linkedin_url": "https://www.linkedin.com/company/salesforce",
        "website_url": "https://www.salesforce.com",
        "primary_domain": "salesforce.com",
        "domains": [
            "salesforce.com",
            "force.com",
            "trailhead.com",
            "tableau.com"
        ],
        "description": "Salesforce is the global leader in Customer Relationship Management (CRM), bringing companies and customers together in the digital age.",
        "industry": "Computer Software",
        "industries": [
            "Computer Software",
            "Cloud Computing",
            "CRM Software"
        ],
        "specialities": [
            "CRM",
            "Cloud Computing",
            "Mobile",
            "Social",
            "Platform",
            "App Development",
            "Analytics"
        ],
        "founded_year": 1999,
        "company_size": "10001+",
        "employee_count": 79390,
        "headquarters": {
            "address": "415 Mission Street, 3rd Floor",
            "city": "San Francisco",
            "state": "California",
            "country": "United States",
            "postal_code": "94105"
        },
        "locations": [
            {
                "city": "San Francisco",
                "state": "California",
                "country": "United States",
                "is_headquarters": true
            },
            {
                "city": "New York",
                "state": "New York", 
                "country": "United States",
                "is_headquarters": false
            }
        ],
        "phone": "+1-415-901-7000",
        "logo_url": "https://logo.clearbit.com/salesforce.com",
        "stock_symbol": "CRM",
        "type": "Public",
        "annual_revenue": {
            "amount": 31352000000,
            "currency": "USD",
            "year": 2023
        },
        "funding": {
            "total_funding": 1700000000,
            "last_funding_round": {
                "type": "IPO",
                "amount": 110000000,
                "date": "2004-06-23",
                "valuation": 1100000000
            },
            "funding_rounds": [
                {
                    "type": "Series A",
                    "amount": 4000000,
                    "date": "1999-12-01"
                }
            ],
            "investors": [
                "Kleiner Perkins",
                "Oracle Corporation"
            ]
        },
        "technology": {
            "categories": [
                "Customer Support",
                "CRM",
                "Analytics",
                "Marketing Automation"
            ],
            "tools": [
                "Slack",
                "Tableau",
                "MuleSoft",
                "Heroku"
            ],
            "integrations": [
                "Microsoft Office 365",
                "Google Workspace",
                "AWS"
            ]
        },
        "contacts": [
            {
                "name": "Marc Benioff",
                "title": "Chairman & CEO",
                "linkedin_url": "https://www.linkedin.com/in/marcbenioff",
                "email": "marc@salesforce.com"
            },
            {
                "name": "Amy Weaver",
                "title": "President & CFO",
                "linkedin_url": "https://www.linkedin.com/in/amy-weaver-salesforce",
                "email": "aweaver@salesforce.com"
            }
        ]
    },
    "statusCode": 200,
    "message": "Success"
}

Overview

Get detailed company information including business details, funding data, technology stack, employee metrics, and more. This endpoint provides comprehensive business intelligence for companies using either their LinkedIn URL or domain.

Authentication

X-API-KEY

string

required

Your Tuesday API key

Query Parameters

linkedin_url

string

LinkedIn company page URLExample: https://www.linkedin.com/company/salesforceNote: Either linkedin_url or domain is required

domain

string

Company domain nameExample: salesforce.comNote: Either linkedin_url or domain is required

include_funding

string

default:"exclude"

Include detailed funding and investment informationOptions: include | excludeAdditional Cost: +2 credits when set to include

include_technology

string

default:"exclude"

Include technology stack and tools used by the companyOptions: include | excludeAdditional Cost: +1 credit when set to include

include_contacts

string

default:"exclude"

Include key executive contacts and leadership informationOptions: include | excludeAdditional Cost: +3 credits when set to include

Response

data

object

Show Company Profile Data

string

Unique identifier for the company

name

string

Company name

linkedin_url

string

LinkedIn company page URL

website_url

string

Primary website URL

primary_domain

string

Primary domain name

domains

array

All associated domain names

description

string

Company description and business overview

industry

string

Primary industry classification

industries

array

All industry classifications

specialities

array

Company specialities and focus areas

founded_year

number

Year the company was founded

company_size

string

Employee count range (e.g., “201-500”)

employee_count

number

Estimated employee count

headquarters

object

Show Headquarters Location

address

string

Full address

city

string

City

state

string

State/region

country

string

Country

postal_code

string

Postal/ZIP code

locations

array

All company office locations

phone

string

Primary phone number

logo_url

string

Company logo image URL

stock_symbol

string

Stock ticker symbol (if publicly traded)

type

string

Company type (e.g., “Public”, “Private”, “Non-profit”)

annual_revenue

object

Revenue information when available

funding

object

Funding details (when include_funding=include)

Show Funding Information

total_funding

number

Total funding raised (USD)

last_funding_round

object

Details of most recent funding round

funding_rounds

array

Complete funding history

investors

array

List of investors and VCs

technology

object

Technology stack (when include_technology=include)

Show Technology Information

Example Requests

curl --location 'https://api.tuesday.so/api/v1/company/profile?domain=salesforce.com' \
--header 'X-API-KEY: your-api-key-here'

curl --location 'https://api.tuesday.so/api/v1/company/profile?linkedin_url=https://www.linkedin.com/company/salesforce' \
--header 'X-API-KEY: your-api-key-here'

curl --location 'https://api.tuesday.so/api/v1/company/profile?domain=salesforce.com&include_funding=include&include_technology=include&include_contacts=include' \
--header 'X-API-KEY: your-api-key-here'

const companyData = async (domain) => {
  const params = new URLSearchParams({
    domain: domain,
    include_funding: 'include',
    include_technology: 'include',
    include_contacts: 'include'
  });

  const response = await fetch(
    `https://api.tuesday.so/api/v1/company/profile?${params}`,
    {
      headers: {
        'X-API-KEY': 'your-api-key-here'
      }
    }
  );

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

// Usage
const salesforce = await companyData('salesforce.com');
console.log(salesforce);

import requests

def get_company_profile(domain=None, linkedin_url=None, full_enrichment=False):
    url = "https://api.tuesday.so/api/v1/company/profile"
    
    params = {}
    if domain:
        params['domain'] = domain
    elif linkedin_url:
        params['linkedin_url'] = linkedin_url
    else:
        raise ValueError("Either domain or linkedin_url is required")
    
    if full_enrichment:
        params.update({
            'include_funding': 'include',
            'include_technology': 'include',
            'include_contacts': 'include'
        })
    
    headers = {'X-API-KEY': 'your-api-key-here'}
    
    response = requests.get(url, params=params, headers=headers)
    return response.json()

# Usage
company = get_company_profile(domain='salesforce.com', full_enrichment=True)
print(f"Company: {company['data']['name']}")
print(f"Employees: {company['data']['employee_count']}")
print(f"Industry: {company['data']['industry']}")

<?php
function getCompanyProfile($domain = null, $linkedinUrl = null, $fullEnrichment = false) {
    $params = [];
    
    if ($domain) {
        $params['domain'] = $domain;
    } elseif ($linkedinUrl) {
        $params['linkedin_url'] = $linkedinUrl;
    } else {
        throw new Exception("Either domain or linkedin_url is required");
    }
    
    if ($fullEnrichment) {
        $params['include_funding'] = 'include';
        $params['include_technology'] = 'include';
        $params['include_contacts'] = 'include';
    }
    
    $queryString = http_build_query($params);
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "https://api.tuesday.so/api/v1/company/profile?$queryString");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'X-API-KEY: your-api-key-here'
    ]);
    
    $response = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($response, true);
}

// Usage
$company = getCompanyProfile('salesforce.com', null, true);
echo "Company: " . $company['data']['name'] . "\n";
echo "Employees: " . $company['data']['employee_count'] . "\n";
?>

Example Response

{
    "data": {
        "id": "tu_cmp_sf2023",
        "name": "Salesforce",
        "linkedin_url": "https://www.linkedin.com/company/salesforce",
        "website_url": "https://www.salesforce.com",
        "primary_domain": "salesforce.com",
        "domains": [
            "salesforce.com",
            "force.com",
            "trailhead.com",
            "tableau.com"
        ],
        "description": "Salesforce is the global leader in Customer Relationship Management (CRM), bringing companies and customers together in the digital age.",
        "industry": "Computer Software",
        "industries": [
            "Computer Software",
            "Cloud Computing",
            "CRM Software"
        ],
        "specialities": [
            "CRM",
            "Cloud Computing",
            "Mobile",
            "Social",
            "Platform",
            "App Development",
            "Analytics"
        ],
        "founded_year": 1999,
        "company_size": "10001+",
        "employee_count": 79390,
        "headquarters": {
            "address": "415 Mission Street, 3rd Floor",
            "city": "San Francisco",
            "state": "California",
            "country": "United States",
            "postal_code": "94105"
        },
        "locations": [
            {
                "city": "San Francisco",
                "state": "California",
                "country": "United States",
                "is_headquarters": true
            },
            {
                "city": "New York",
                "state": "New York", 
                "country": "United States",
                "is_headquarters": false
            }
        ],
        "phone": "+1-415-901-7000",
        "logo_url": "https://logo.clearbit.com/salesforce.com",
        "stock_symbol": "CRM",
        "type": "Public",
        "annual_revenue": {
            "amount": 31352000000,
            "currency": "USD",
            "year": 2023
        },
        "funding": {
            "total_funding": 1700000000,
            "last_funding_round": {
                "type": "IPO",
                "amount": 110000000,
                "date": "2004-06-23",
                "valuation": 1100000000
            },
            "funding_rounds": [
                {
                    "type": "Series A",
                    "amount": 4000000,
                    "date": "1999-12-01"
                }
            ],
            "investors": [
                "Kleiner Perkins",
                "Oracle Corporation"
            ]
        },
        "technology": {
            "categories": [
                "Customer Support",
                "CRM",
                "Analytics",
                "Marketing Automation"
            ],
            "tools": [
                "Slack",
                "Tableau",
                "MuleSoft",
                "Heroku"
            ],
            "integrations": [
                "Microsoft Office 365",
                "Google Workspace",
                "AWS"
            ]
        },
        "contacts": [
            {
                "name": "Marc Benioff",
                "title": "Chairman & CEO",
                "linkedin_url": "https://www.linkedin.com/in/marcbenioff",
                "email": "marc@salesforce.com"
            },
            {
                "name": "Amy Weaver",
                "title": "President & CFO",
                "linkedin_url": "https://www.linkedin.com/in/amy-weaver-salesforce",
                "email": "aweaver@salesforce.com"
            }
        ]
    },
    "statusCode": 200,
    "message": "Success"
}

Credit Usage

Base Profile

Technology Stack

Funding Data

Executive Contacts

Data Sources & Accuracy

Data Sources

Company data is aggregated from multiple sources:

LinkedIn company pages and employee profiles
Company websites and SEC filings
Funding databases (Crunchbase, PitchBook)
Technology tracking services
Public business registries

Update Frequency

Basic company information: Updated weekly
Employee counts: Updated monthly
Funding data: Updated within 24-48 hours of announcements
Technology stack: Updated quarterly
Executive contacts: Updated bi-weekly

Data Quality

Public companies: 95%+ accuracy on core data
Private companies: 85-90% accuracy
Startups (<2 years): 75-85% accuracy
Technology data: 80-85% accuracy
Contact information: 70-75% accuracy

Best Practices

Domain vs LinkedIn URL

Use domain when:

You have the company’s primary website
Working with large datasets of domains
Domain is well-established and matches company name

Use LinkedIn URL when:

Domain lookup returns incorrect company
Working with subsidiaries or divisions
Need to ensure exact company match

Enrichment Strategy

Start with basic profile to verify the company, then add enrichments:

Basic profile (1 credit) - Verify company identity
Add funding data (+2 credits) - For investment analysis
Add technology (+1 credit) - For competitive intelligence
Add contacts (+3 credits) - For sales outreach

Handling Large Companies

For companies with subsidiaries:

Each subsidiary may have its own profile
Use specific LinkedIn URLs for divisions
Check domains array for all associated domains
Consider using Company Search to find related entities

Error Responses

400 Bad Request - Missing Parameters

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Either domain or linkedin_url parameter is required"
}

404 Not Found - Company Not Found

{
    "statusCode": 404,
    "message": "Not Found",
    "error": "No company found matching the provided criteria"
}

400 Bad Request - Invalid LinkedIn URL

{
    "statusCode": 400,
    "message": "Bad Request",
    "error": "Invalid LinkedIn URL format. Must be a company page URL"
}

Use Cases

Sales Intelligence

Research target companies before sales outreach and meetings

Market Research

Analyze competitors, market sizing, and industry trends

Investment Due Diligence

Evaluate companies for investment opportunities and partnerships

Lead Qualification

Qualify inbound leads and prioritize high-value prospects

Competitive Analysis

Monitor competitor technology stacks and strategic moves

Account-Based Marketing

Create targeted campaigns based on company characteristics

Company Profile Fields

Basic Information

Always included in the base response:

Company name and description
Industry and specialties
Founded year and size
Website and LinkedIn URLs
Headquarters location

Enhanced Data (Base)

Included when available:

Multiple office locations
Phone number and logo
Stock symbol (public companies)
Revenue information
All associated domains

Funding Information (+2 credits)

Total funding raised
Funding round history
Investor list
Valuation data
IPO information

Technology Stack (+1 credit)

Software categories used
Specific tools and platforms
Third-party integrations
Technology partnerships

Executive Contacts (+3 credits)

C-level executives
VP-level leadership
Key decision makers
Direct contact information

Company Search API - Search for companies with filters
Company Employee Count - Get detailed employee metrics
Company Employee Search - Find employees within companies
People Search API - Find people at specific companies

People Search Company Employee Count

Authentication

People APIs

Company APIs

Get Company Profile

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Credit Usage

Data Sources & Accuracy

Best Practices

Error Responses

Use Cases

Sales Intelligence

Market Research

Investment Due Diligence

Lead Qualification

Competitive Analysis

Account-Based Marketing

Company Profile Fields

​Overview

​Authentication

​Query Parameters

​Response

​Example Requests

​Example Response

​Credit Usage

​Data Sources & Accuracy

​Best Practices

​Error Responses

​Use Cases

Sales Intelligence

Market Research

Investment Due Diligence

Lead Qualification

Competitive Analysis

Account-Based Marketing

​Company Profile Fields

​Related Endpoints

Overview

Authentication

Query Parameters

Response

Example Requests

Example Response

Credit Usage

Data Sources & Accuracy

Best Practices

Error Responses

Use Cases

Company Profile Fields

Related Endpoints