# Company Database

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/company` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/company |

## Description

Retrieve comprehensive company data including financials, technologies, social profiles, and location by domain name.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/company' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup gucci.com

```json
{
  "name": "Gucci",
  "domain": "gucci.com",
  "founded": 1921,
  "revenue": "over-1b",
  "location": {
    "lat": "43.7567104",
    "lng": "11.1847619",
    "city": "Scandicci",
    "address": null,
    "country": "Italy",
    "postcode": "50018",
    "country_code": "IT"
  },
  "domain_tld": "com",
  "industries": [
    "fashion",
    "jewelry",
    "leather-goods",
    "leisure",
    "luxury-goods",
    "luxury-goods-and-jewelry",
    "mens-clothing",
    "shopping",
    "womens-clothing"
  ],
  "updated_at": null,
  "description": "Influential, innovative and progressive, Gucci is reinventing a wholly modern approach to fashion. Under the new vision of creative director Alessandro Michele, the House has redefined luxury for the 21st century, further reinforcing its position as one of the world's most desirable fashion houses. Eclectic, contemporary, romantic-Gucci products represent the pinnacle of Italian craftsmanship and are unsurpassed for their quality and attention to detail. Gucci is part of the Kering Group, a world leader in apparel and accessories that owns a portfolio of powerful luxury and sport and lifestyle brands. For further information about Gucci, visit www.gucci.com",
  "domain_name": "gucci",
  "staff_range": "over-10k",
  "phone_number": "+39 055 759221",
  "technologies": [
    "akamai",
    "amazon-cloudfront",
    "amazon-s3",
    "apache",
    "facebook-social-plugins",
    "google-analytics",
    "google-cloud",
    "google-tag-manager",
    "java",
    "nginx",
    "riskified",
    "sap-commerce-cloud"
  ],
  "business_type": null,
  "social_networks": {
    "twitter": "http://twitter.com/gucci",
    "youtube": "https://youtube.com/user/gucciofficial",
    "facebook": "http://www.facebook.com/gucci",
    "linkedin": "https://www.linkedin.com/company/6585",
    "instagram": "https://instagram.com/gucci",
    "pinterest": "https://pinterest.com/gucci",
    "twitter_id": "gucci",
    "youtube_id": "gucciofficial",
    "facebook_id": "gucci",
    "instagram_id": "gucci",
    "pinterest_id": "gucci",
    "linkedin_id_alpha": "gucci",
    "linkedin_id_numeric": 6585,
    "linkedin_sales_navigator": "https://www.linkedin.com/sales/company/6585"
  },
  "monthly_visitors": "100m-500m",
  "technology_categories": [
    "accounting-and-finance",
    "application-development",
    "application-server",
    "archive-storage",
    "block-storage",
    "cloud-file-storage",
    "cloud-platform-as-a-service",
    "commerce",
    "container-management",
    "content-delivery-network",
    "digital-analytics",
    "e-commerce",
    "e-commerce-fraud-protection",
    "e-commerce-platforms",
    "enterprise-content-delivery-network",
    "erp",
    "hosting",
    "marketing",
    "security",
    "tag-management",
    "web-accelerator",
    "web-security"
  ]
}
```

### Lookup stripe.com

```json
{
  "name": "Stripe",
  "domain": "stripe.com",
  "founded": 2010,
  "revenue": "100m-200m",
  "location": {
    "lat": "37.7790262",
    "lng": "-122.419906",
    "city": "San Francisco",
    "address": "510 townsend street",
    "country": "United States",
    "postcode": null,
    "country_code": "US"
  },
  "domain_tld": "com",
  "industries": [
    "cloud-infrastructure",
    "computer-software",
    "consumer-goods",
    "credit-cards",
    "developer-apis",
    "developer-tools",
    "enterprise-software",
    "finance",
    "information-technology",
    "internet",
    "payments",
    "saas",
    "software"
  ],
  "updated_at": null,
  "description": "Stripe is a set of tools for building and running an internet business. We help businesses accept payments from anyone, anywhere, and build new kinds of companies like Lyft or Kickstarter. Internally, we say our goal is to increase the GDP of the internet---we want to bring more businesses online worldwide.",
  "domain_name": "stripe",
  "staff_range": "5k-10k",
  "phone_number": "(650) 427-9276",
  "technologies": [
    "amazon-cloudfront",
    "amazon-ecs",
    "amazon-s3",
    "apache",
    "cloudflare-cdn",
    "envoy-proxy",
    "facebook-social-plugins",
    "google-analytics",
    "google-tag-manager",
    "microsoft-azure-cdn",
    "nginx",
    "sentry",
    "stripe"
  ],
  "business_type": null,
  "social_networks": {
    "twitter": "http://twitter.com/stripe",
    "facebook": "https://www.facebook.com/stripehq",
    "linkedin": "https://www.linkedin.com/company/2135371",
    "angellist": "http://angel.co/stripe",
    "twitter_id": "stripe",
    "facebook_id": "stripehq",
    "angellist_id": "stripe",
    "linkedin_id_alpha": "stripe",
    "linkedin_id_numeric": 2135371,
    "linkedin_sales_navigator": "https://www.linkedin.com/sales/company/2135371"
  },
  "monthly_visitors": "100m-500m",
  "technology_categories": [
    "application-development",
    "application-performance-monitoring",
    "application-server",
    "archive-storage",
    "bug-tracking",
    "cloud-security",
    "commerce",
    "content-delivery-network",
    "digital-analytics",
    "financial-data-apis",
    "financial-services",
    "hosting",
    "load-balancing",
    "marketing",
    "monitoring",
    "payment",
    "payment-gateways",
    "security",
    "tag-management",
    "web-security"
  ]
}
```

### Lookup pennylane.com

```json
{
  "name": "Pennylane",
  "domain": "pennylane.com",
  "founded": null,
  "revenue": null,
  "location": {
    "lat": null,
    "lng": null,
    "city": null,
    "address": null,
    "country": null,
    "postcode": null,
    "country_code": null
  },
  "domain_tld": "com",
  "industries": [],
  "updated_at": null,
  "description": "Pennylane est la plateforme tout-en-un de gestion financière et comptabilité des dirigeants d'entreprise et de leurs experts-comptables",
  "domain_name": "pennylane",
  "staff_range": null,
  "phone_number": null,
  "technologies": [
    "amazon-cloudfront",
    "amazon-s3",
    "contentful",
    "cowboy",
    "erlang",
    "google-analytics",
    "google-tag-manager",
    "google-workspace",
    "ruby",
    "ruby-on-rails"
  ],
  "business_type": null,
  "social_networks": {
    "twitter": "https://twitter.com/pennylane_tech",
    "facebook": "https://facebook.com/pennylane.com",
    "linkedin": "https://linkedin.com/company/pennylaneaccounting",
    "instagram": "https://instagram.com/pennylane_accounting",
    "twitter_id": "pennylane_tech",
    "facebook_id": "pennylane.com",
    "instagram_id": "pennylane_accounting",
    "linkedin_id_alpha": "pennylaneaccounting",
    "linkedin_id_numeric": null
  },
  "monthly_visitors": "under-10k",
  "technology_categories": [
    "application-development",
    "application-server",
    "cloud-content-collaboration",
    "content-delivery-network",
    "content-management",
    "digital-analytics",
    "headless-cms",
    "hosting",
    "marketing",
    "mobile-development",
    "object-storage",
    "programming-languages",
    "tag-management",
    "web-frameworks"
  ]
}
```

## Documentation

## Overview
The Company Database endpoint retrieves comprehensive firmographic data about any company by querying its domain name. It taps a database of over 60 million companies, returning details ranging from company description and financials to technology stack, social network profiles, and geolocation, all from a single domain lookup.

## Quickstart
```
GET https://api.piloterr.com/v2/company?query=gucci.com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Domain name (e.g. `gucci.com`, `https://gucci.com`, `www.gucci.com`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `name` | string | Company name |
| `domain` | string | Company domain name |
| `domain_name` | string | Domain name portion |
| `domain_tld` | string | Top-level domain |
| `business_type` | string | Business type (if available) |
| `monthly_visitors` | string | Estimated monthly website visitors range |
| `phone_number` | string | Company phone number |
| `revenue` | string | Estimated annual revenue range |
| `staff_range` | string | Estimated employee count range |
| `founded` | integer | Year the company was founded |
| `description` | string | Company description |
| `industries` | array | Industries the company operates in |
| `social_networks` | object | Social media profiles (linkedin, twitter, facebook, instagram, youtube, pinterest) |
| `technologies` | array | Technologies used by the company |
| `technology_categories` | array | Technology category tags |
| `location` | object | Company headquarters (address, city, country, lat, lng, postcode, country_code) |

## Notes
- Domain uniqueness ensures accurate company identification: prefer using domain over company name
- Some fields may be `null` if data is unavailable for that company
- Social network fields include both profile URLs and handle IDs

## Main use cases
- Enrich CRM records with firmographic data using only a company domain
- Build lead scoring pipelines using revenue, staff size, and technology signals
- Identify the tech stack of target accounts for sales and marketing personalization
- Aggregate social network profiles for outreach automation across channels