Search

Changed on Dec 5, 2024

Returns Grata-powered search results based on an input search query.

post/api/v1.4/search/

Request

Base URL
https://search.grata.com
Auth
API key in header Authorization

Request body

group_operator'any' | 'all'

terms_excludestring[]

page_tokenstring

Page token used for pagination.

end_customerstring[]

ownershipstring[]

business_modelsstring[]

is_fundedboolean

Indicates whether the company has received outside funding.

funding_sizenumber[]

funding_stagestring[]

employees_change_time'month' | 'quarter' | 'six_month' | 'annual'

grata_employees_estimates_rangenumber[]

employees_on_professional_networks_rangenumber[]

employees_changenumber[]

year_foundednumber[]

Response

countinteger required

Total number of items.

page_tokenstring required

Token for pagination.

Example response

{
  "count": 100,
  "page_token": "abc123",
  "companies": [
    {
      "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"
      }
    }
  ]
}

Changes

Dec 5, 2024b36e8e329afb Revision changes
- breaking
  added to the request body allOf list
- breaking
  the request's body type changed from object to no type
- breaking
  the response's body type changed from object to no type for status
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api operation id search removed and replaced with post-search
- info
  the endpoint scheme security ApiKeyAuth was removed from the API
- info
  api tag search added
- info
  added subschema #2 to the response body allOf list for the response status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
Dec 5, 2024f80fb2a115ff Revision changes
- breaking
  request body became required
- breaking
  the request property /// became not nullable
- breaking
  the request property /// became not nullable
- breaking
  the request property /// became not nullable
- breaking
  the request property /// became not nullable
- breaking
  removed the enum value agriculture of the request property /
- breaking
  removed the enum value b2b of the request property /
- breaking
  removed the enum value b2c of the request property /
- breaking
  removed the enum value bootstrapped of the request property /
- breaking
  removed the enum value colleges_and_universities of the request property /
- breaking
  removed the enum value commercial_and_residential_services of the request property /
- breaking
  removed the enum value consumer_product_and_retail of the request property /
- breaking
  removed the enum value content_and_publishing of the request property /
- breaking
  removed the enum value directory of the request property /
- breaking
  removed the enum value distributor of the request property /
- breaking
  removed the enum value early_stage_funding of the request property /
- breaking
  removed the enum value education of the request property /
- breaking
  removed the enum value education of the request property /
- breaking
  removed the enum value electronics of the request property /
- breaking
  removed the enum value finance of the request property /
- breaking
  removed the enum value government of the request property /
- breaking
  removed the enum value government of the request property /
- breaking
  removed the enum value hardware of the request property /
- breaking
  removed the enum value healthcare of the request property /
- breaking
  removed the enum value hospitality_and_leisure of the request property /
- breaking
  removed the enum value hospitals_and_medical_centers of the request property /
- breaking
  removed the enum value industrials of the request property /
- breaking
  removed the enum value information_technology of the request property /
- breaking
  removed the enum value investment_banks_and_business_brokers of the request property /
- breaking
  removed the enum value investor_backed of the request property /
- breaking
  removed the enum value job_site of the request property /
- breaking
  removed the enum value late_stage_funding of the request property /
- breaking
  removed the enum value manufacturer of the request property /
- breaking
  removed the enum value marketplace of the request property /
- breaking
  removed the enum value media of the request property /
- breaking
  removed the enum value nonprofit_and_associations of the request property /
- breaking
  removed the enum value other_funding of the request property /
- breaking
  removed the enum value pre_ipo_funding of the request property /
- breaking
  removed the enum value private_equity of the request property /
- breaking
  removed the enum value private_equity_add_on of the request property /
- breaking
  removed the enum value private_equity_and_venture_capital of the request property /
- breaking
  removed the enum value private_equity_backed of the request property /
- breaking
  removed the enum value private_schools of the request property /
- breaking
  removed the enum value private_subsidiary of the request property /
- breaking
  removed the enum value producer of the request property /
- breaking
  removed the enum value professional_services of the request property /
- breaking
  removed the enum value public of the request property /
- breaking
  removed the enum value public_subsidiary of the request property /
- breaking
  removed the enum value religious_institutions of the request property /
- breaking
  removed the enum value retailer of the request property /
- breaking
  removed the enum value services of the request property /
- breaking
  removed the enum value software of the request property /
- breaking
  removed the enum value software_enabled of the request property /
- breaking
  removed the enum value staffing_and_recruiting of the request property /
- breaking
  removed the enum value transportation of the request property /
- breaking
  removed the enum value us_federal_agencies of the request property /
- breaking
  the / request property type changed from number to integer
- breaking
  the / request property type changed from number to integer
- breaking
  the / request property type changed from number to integer
- breaking
  the / request property type changed from number to integer
- warning
  deleted the header request parameter Content-Type
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  api operation id post-search removed and replaced with search
- info
  the endpoint scheme security ApiKeyAuth was added to the API
- info
  added the new optional request property ///
- info
  added the optional property to the response with the status

Operation history (3 revisions)