> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpg.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies

> Retrieve company data, profiles, content, contacts, and technology stacks

## Search Accounts

Search for companies (accounts) across your organization using a variety of filters. Send an empty body `{}` to return all results.

<ParamField body="company_name" type="string">
  Filter by company name (partial match).
</ParamField>

<ParamField body="industry" type="string">
  Filter by industry.
</ParamField>

<ParamField body="country" type="string">
  Filter by country.
</ParamField>

<ParamField body="employee_size_category" type="string">
  Filter by employee size category.
</ParamField>

<ParamField body="revenue_category" type="string">
  Filter by revenue category.
</ParamField>

<ParamField body="public_company" type="boolean">
  Filter by public company status.
</ParamField>

<ParamField body="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField body="per_page" type="integer" default="50">
  Number of items per page.
</ParamField>

**Permission:** `accounts:read`

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.getpg.ai/public-api/v1/accounts" \
    -H "x-api-key: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "industry": "Technology",
      "per_page": 10
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "0472a8a1-bdc4-4f53-93f6-7d9a967beb76",
      "company_name": "Sprout Social",
      "website_domain": "sproutsocial.com",
      "public_company": true,
      "country_code": "US",
      "linkedin_url": "https://www.linkedin.com/company/sprout-social-inc-",
      "hq_city": "Chicago",
      "hq_state": "IL",
      "hq_country_name": "United States",
      "region": "North America",
      "ceo": "Mr. Ryan Paul Barretto",
      "sector": "Technology",
      "industry": "Apps",
      "revenue_range": "$100M-$500M",
      "employee_count_range": "1001-5000",
      "full_time_employees": 1322,
      "description": "Sprout Social, Inc. designs, develops, and operates a web-based social media management platform...",
      "stock_ticker": "SPT",
      "market_cap": 337111258,
      "stock_currency": "USD",
      "stock_exchange_name": "NASDAQ Capital Market"
    }
  ]
  ```
</ResponseExample>

***

## Get Company

Retrieve detailed information about a specific company by its ID.

<ParamField path="company_id" type="string" required>
  The unique identifier (UUID) of the company.
</ParamField>

**Permission:** `insights:read`

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.getpg.ai/public-api/v1/companies/{company_id}" \
    -H "x-api-key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "company_id": "0472a8a1-bdc4-4f53-93f6-7d9a967beb76",
    "company_name": "Sprout Social",
    "website_domain": "sproutsocial.com",
    "public_company": true,
    "country_code": "US",
    "linkedin_url": "https://www.linkedin.com/company/sprout-social-inc-",
    "hq_city": "Chicago",
    "hq_state": "IL",
    "hq_country_name": "United States",
    "region": "North America",
    "ceo": "Mr. Ryan Paul Barretto",
    "sector": "Technology",
    "industry": "Apps",
    "revenue_range": "$100M-$500M",
    "employee_count_range": "1001-5000",
    "full_time_employees": 1322,
    "description": "Sprout Social, Inc. designs, develops, and operates a web-based social media management platform...",
    "stock_ticker": "SPT",
    "market_cap": 337111258,
    "stock_currency": "USD",
    "stock_exchange_name": "NASDAQ Capital Market",
    "stock_exchange_symbol": "NASDAQ"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 400 theme={null}
  {
    "error": {
      "type": "validation_error",
      "code": "invalid_uuid",
      "message": "Not a valid UUID."
    }
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 403 theme={null}
  {
    "error": {
      "type": "authorization_error",
      "code": "forbidden",
      "message": "You do not have access to this company"
    }
  }
  ```
</ResponseExample>

***

## Get Company Profile

Retrieve a customizable company profile with selectable sections. Use the `include` parameter to request specific sections, or pass `full` to get everything.

<ParamField path="company_id" type="string" required>
  The unique identifier (UUID) of the company.
</ParamField>

<ParamField query="include" type="string">
  Comma-separated list of profile sections to include. Use `full` for all sections.

  Available sections: `overview`, `key_executives`, `divisions`, `geographical_operations`, `swot_analysis`, `competitors`, `industry_insights`, `strategic_priorities`, `digital_strategies`, `risks`, `goals`, `insights_scores`, `events`, `value_pyramid`, `three_whys`, `discovery_questions`, `how_they_make_money`, `how_they_lose_money`, `custom_insights`, `employee_groups`, `favourite_technologies_count`, `territory_custom_scores`, `content`
</ParamField>

<ParamField query="exclude" type="string">
  Comma-separated list of profile sections to exclude. Useful when requesting `full` but omitting certain sections.
</ParamField>

<ParamField query="sources" type="string">
  Set to `true` to include source citations alongside profile data.
</ParamField>

**Permission:** `insights:read`

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.getpg.ai/public-api/v1/companies/{company_id}/profile?include=overview,swot_analysis,competitors,key_executives" \
    -H "x-api-key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "company_id": "0472a8a1-bdc4-4f53-93f6-7d9a967beb76",
    "company_name": "Sprout Social",
    "website_domain": "sproutsocial.com",
    "hq_country_name": "United States",
    "industry": "Apps",
    "revenue_range": "$100M-$500M",
    "employee_count_range": "1001-5000",
    "overview": {
      "public_company": true,
      "country_code": "US",
      "linkedin_url": "https://www.linkedin.com/company/sprout-social-inc-",
      "hq_city": "Chicago",
      "hq_state": "IL",
      "region": "North America",
      "ceo": "Mr. Ryan Paul Barretto",
      "sector": "Technology",
      "full_time_employees": 1322,
      "description": "Sprout Social, Inc. designs, develops, and operates a web-based social media management platform..."
    },
    "swot_analysis": [
      {
        "name": "AI-Powered Platform with Proprietary Trellis Agent",
        "type": "STRENGTH",
        "description": "Sprout Social has developed a proprietary AI agent called Trellis that transforms social data into actionable insights..."
      },
      {
        "name": "Limited International Presence",
        "type": "WEAKNESS",
        "description": "Despite growing international revenue, Sprout Social remains heavily concentrated in the North American market..."
      },
      {
        "name": "AI-Driven Social Commerce",
        "type": "OPPORTUNITY",
        "description": "The convergence of social media and e-commerce presents a significant growth opportunity..."
      },
      {
        "name": "Increasing Competition from AI-Native Platforms",
        "type": "THREAT",
        "description": "New AI-native social media management platforms pose a competitive threat..."
      }
    ],
    "competitors": [
      {
        "name": "Hootsuite",
        "website": "https://hootsuite.com",
        "description": "Hootsuite is a comprehensive social media management platform..."
      },
      {
        "name": "Zoho Social",
        "website": "https://www.zoho.com/social/",
        "description": "Zoho Social is a social media management tool..."
      }
    ],
    "key_executives": [
      {
        "name": "Ryan Barretto",
        "title": "Chief Executive Officer and Member of the Board of Directors"
      },
      {
        "name": "Justyn Howard",
        "title": "Executive Chair and Member of the Board of Directors"
      }
    ]
  }
  ```
</ResponseExample>

***

## Search Company Contacts

Search and filter contacts associated with a specific company. Uses POST to support complex filter combinations in the request body.

<ParamField path="company_id" type="string" required>
  The unique identifier (UUID) of the company.
</ParamField>

<ParamField body="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField body="per_page" type="integer" default="25">
  Number of items per page.
</ParamField>

<ParamField body="name" type="string">
  Filter contacts by name.
</ParamField>

<ParamField body="job_title" type="string">
  Filter contacts by job title.
</ParamField>

<ParamField body="location" type="string">
  Filter contacts by location.
</ParamField>

**Permission:** `contacts:read`

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.getpg.ai/public-api/v1/companies/{company_id}/contacts" \
    -H "x-api-key: your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "per_page": 10
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "contacts": [
      {
        "id": "deb3474b-5836-492c-aca4-4e0ccc8afbae",
        "full_name": "Iain Donachie",
        "first_name": "Iain",
        "last_name": "Donachie",
        "current_job_title": "Head of Gift Cards UK & Ireland, Tesco",
        "linkedin_url": "https://www.linkedin.com/in/iain-donachie-6bb3406",
        "location": "Edinburgh, Scotland, United Kingdom",
        "country": "United Kingdom",
        "country_code": "GB",
        "summary": "",
        "image_url": "https://media.licdn.com/dms/image/...",
        "created_at": "2026-04-01T12:47:07.324Z",
        "updated_at": null
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 10,
      "total": 42,
      "total_pages": 5
    }
  }
  ```
</ResponseExample>

***

## Get Company Technologies

Retrieve the technology stack for a company with optional filtering. Pass all filters as query parameters.

<ParamField path="company_id" type="string" required>
  The unique identifier (UUID) of the company.
</ParamField>

<ParamField query="category" type="string">
  Filter by technology category. Valid categories include: `Data, BI and Analytics`, `Collaboration`, `Communications`, `Customer Management`, `Devops And Development`, `E-commerce`, `Finance And Accounting`, `IT Security`, `Marketing`, `Sales`, and more.
</ParamField>

<ParamField query="confidence" type="string">
  Filter by detection confidence level (`high`, `medium`, `low`).
</ParamField>

<ParamField query="favourites" type="boolean">
  Set to `true` to only return technologies marked as favourites in your workspace.
</ParamField>

<ParamField query="q" type="string">
  Free-text search to filter technologies by name.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number for pagination.
</ParamField>

<ParamField query="per_page" type="integer" default="100">
  Number of items per page.
</ParamField>

**Permission:** `insights:read`

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.getpg.ai/public-api/v1/companies/{company_id}/technologies?category=IT+Security&per_page=50" \
    -H "x-api-key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "name": "Cloudflare",
      "category": "IT Security",
      "sub_category": "CDN & DDoS Protection",
      "confidence": "high"
    },
    {
      "name": "CrowdStrike",
      "category": "IT Security",
      "sub_category": "Endpoint Security",
      "confidence": "medium"
    }
  ]
  ```
</ResponseExample>