v5

latestOpenAPI 3.1.0raw.githubusercontent.com2024-12-05103351.8 KB

enrichment

Enrich

Provide a company domain or Grata-specific company ID to return relevant firmographic data on a company.

post/api/v1.4/enrich/

Request body

domainstring required

Domain of the company being enriched. Protocol and path can be included. If both the domain and company_uid are included, the domain will be used.

company_uidstring

Unique alphanumeric Grata ID for the company (case-sensitive).

Example request

{
  "domain": "slack.com",
  "company_uid": "7W46XUJT"
}

Response

namestring required

Name of the company.

company_uidstring required

Unique alphanumeric Grata ID for the company (case-sensitive).

urlstring

URL to the company's Grata profile.

domainstring

Domain of the company.

descriptionstring

Description of the company.

is_activestring

Indicates if this company is active in platform.

headquartersstring

City and region of headquarters.

revenue_estimatesnumber

Grata's revenue estimate

grata_employee_estimatesinteger

Grata's employee estimates

employees_on_professional_networksinteger

The number of employees on professional networks.

primary_phonestring

Primary company phone number from home page or contact section of the website.

primary_emailstring

Primary company email from home page or contact section of the website.

social_linkedinstring

Link to the company's LinkedIn page.

social_facebookstring

Link to the company's Facebook page.

social_twitterstring

Link to the company's Twitter page.

social_instagramstring

Link to the company's Instagram page.

social_crunchbasestring

Link to the company's Crunchbase page.

Current ownership status of the company.

The company's entity classification.

Ultimate owner company type.

The type of organization.

year_foundedinteger

Founding year of the company.

Stage of funding a company has received.

latest_funding_datestring date

The date of the last funding round.

latest_funding_amountnumber

The last funding amount received.

latest_funding_roundstring

The type of the last funding round.

total_fundingnumber

The total funding amount received.

funding_rounds_countinteger

Rounds of equity funding the company has received.

keywordsstring[]

Top 10 most relevant keywords that relate to the company's operations.

end_customerstring[]

End vertical that the company sells to.

business_modelsstring[]

Method of product or service delivery.

Example response

{
  "name": "Slack",
  "company_uid": "26AJRCR2",
  "url": "https://search.grata.com/search?c=7W46XUJT",
  "domain": "slack.com",
  "description": "Slack has transformed business communication. It is the leading channel-based messaging platform...",
  "domains": [
    {
      "domain": "slack.com"
    }
  ],
  "is_active": "Active",
  "headquarters": "San Francisco, California",
  "locations": {
    "locations": [
      {
        "location_type": "HQ",
        "city_name": "San Francisco",
        "continent_name": "North America",
        "country_iso2": "US",
        "country_iso3": "USA",
        "country_name": "United States",
        "house_number": "123",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "macro_region": "Silicon Valley",
        "micro_region": "Bay Area",
        "postal_code": "94105",
        "raw_address": "123 Market St, San Francisco, CA 94105, USA",
        "region_iso": "CA",
        "region_name": "California",
        "street": "Market St",
        "greater_regions": [
          {
            "name": "San Francisco Bay Area"
          }
        ]
      }
    ],
    "total": 5
  },
  "revenue_estimates": 2000000000,
  "grata_employee_estimates": 2000,
  "employee_location_breakdown": [
    {
      "country": "USA",
      "country_percentage": 0.95,
      "confidence": "High"
    }
  ],
  "employees_on_professional_networks": 20,
  "employees_growth": {
    "percentage_one_month": 0.1,
    "percentage_three_month": 0.1,
    "percentage_six_month": 0.1,
    "percentage_one_year": 0.1
  },
  "primary_phone": "18888888888",
  "primary_email": "support@slack.com",
  "social_linkedin": "https://linkedin.com/company/slack",
  "social_facebook": "https://facebook.com/slackhq",
  "social_twitter": "https://twitter.com/slackhq",
  "social_instagram": "https://instagram.com/slackhq",
  "social_crunchbase": "https://crunchbase.com/organization/slack",
  "ownership_status": "Public Subsidiary",
  "entity_type": "Public",
  "owner": {
    "id": "OWNER123",
    "name": "John Doe",
    "domain": "johndoe.com",
    "status": "Active"
  },
  "ultimate_owner": {
    "id": "OWNER123",
    "name": "John Doe",
    "domain": "johndoe.com",
    "status": "Active"
  },
  "year_founded": 2009,
  "funding_rounds_count": 1,
  "classifications": {
    "industry_classifications": [
      {
        "industry_code": "513210",
        "industry_name": "Software Publishers"
      }
    ],
    "software_industries": [
      {
        "industry_code": "51321006",
        "industry_name": "IT Security and Privacy Software"
      }
    ]
  },
  "conferences": {
    "conferences": [
      {
        "name": "Tech Innovators Summit",
        "company_count": 150,
        "start_date": "2024-09-15",
        "end_date": "2024-09-17",
        "url": "https://techinnovatorssummit.com",
        "location": "San Francisco, CA"
      }
    ],
    "count": 2
  },
  "contacts": {
    "contacts": [
      {
        "name": "Alice Smith",
        "title": "Director of Sales",
        "work_email": "alice.smith@slack.com",
        "email_deliverability": "Verified",
        "socials_linkedin": "https://linkedin.com/in/alicesmith",
        "socials_twitter": "https://twitter.com/alicesmith",
        "socials_facebook": "https://facebook.com/alicesmith",
        "age": 35
      }
    ],
    "count": 5
  },
  "investors": {
    "id": "INV123",
    "name": "Venture Capital Partners",
    "domain": "venturecapital.com"
  }
}

All 10 operations