# Company Database Social

## Overview

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

## Description

Resolve a company profile from a social network URL and return full firmographic data including domain, industry, staff, and technologies.

## 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/social' \
  --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
Pass a social network profile URL (LinkedIn, Twitter, Instagram, etc.) and retrieve the matching company record from the Piloterr Company Database, including domain, industries, location, revenue, technologies, and social links.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Social profile URL of the company |

## Main use cases
- Reverse-lookup a company from any social profile URL
- Enrich lead records when only a social link is available
- Map social accounts to canonical company domains for CRM sync