# Company Suggest

## Overview

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

## Description

Autocomplete company search by name or keyword and return matching company records with domain and firmographic data.

## 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/suggest' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```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": "2022-12-25T16:30:51+00:00",
  "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",
    "container-networking",
    "container-orchestration",
    "container-registry",
    "containerization",
    "content-analytics",
    "content-delivery-network",
    "content-marketing",
    "ddos-protection",
    "development",
    "devops",
    "devsecops",
    "digital-analytics",
    "e-commerce",
    "e-commerce-fraud-protection",
    "e-commerce-platforms",
    "enterprise-content-delivery-network",
    "erp",
    "fraud-detection",
    "hosting",
    "hybrid-cloud-storage",
    "it-infrastructure",
    "load-balancing",
    "marketing",
    "mobile-analytics",
    "mobile-app-analytics",
    "mobile-development",
    "object-storage",
    "omnichannel-commerce",
    "order-management",
    "programming-languages",
    "security",
    "social-media-marketing",
    "storage-management",
    "tag-management",
    "virtual-private-cloud",
    "web-accelerator",
    "web-application-firewalls",
    "web-security",
    "web-server-accelerator"
  ]
}
```

## Documentation

## Overview
Search the Piloterr Company Database by partial name or keyword. Returns matching companies with domain, industry, location, revenue range, technologies, and social profiles: ideal for autocomplete UIs and bulk enrichment pipelines.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Company name or search keyword |

## Main use cases
- Power autocomplete in CRM or prospecting tools
- Resolve ambiguous company names to canonical domains
- Build company pickers for enrichment workflows