Sign in
search

Search

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

post/api/v1.4/search/

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

OK

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

Changed in 3 of the 5 revisions of this API.632613

  • b36e8e329afb3209See the full diff
    • ▲

      added SearchFiltersBase to the request body allOf list

      request-body-all-of-added

    • ▲

      the request's body type/format changed from object/ to /

      request-body-type-changed

    • ▲

      the response's body type/format changed from object/ to / for status 200

      response-body-type-changed

    • ●

      removed the request property business_models

      request-property-removed

    • ●

      removed the request property employees_change

      request-property-removed

    • ●

      removed the request property employees_change_time

      request-property-removed

    • ●

      removed the request property employees_on_professional_networks_range

      request-property-removed

    • ●

      removed the request property end_customer

      request-property-removed

    • ●

      removed the request property funding_size

      request-property-removed

    • ●

      removed the request property funding_stage

      request-property-removed

    • ●

      removed the request property grata_employees_estimates_range

      request-property-removed

    • ●

      removed the request property headquarters

      request-property-removed

    • ●

      removed the request property industry_classifications

      request-property-removed

    • ●

      removed the request property is_funded

      request-property-removed

    • ●

      removed the request property lists

      request-property-removed

    • ●

      removed the request property ownership

      request-property-removed

    • ●

      removed the request property page_token

      request-property-removed

    • ●

      removed the request property terms_exclude

      request-property-removed

    • ●

      removed the request property terms_include

      request-property-removed

    • ●

      removed the request property year_founded

      request-property-removed

    • ●

      removed the optional property companies from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property count from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property page_token from the response with the 200 status

      response-optional-property-removed

    • ○

      api operation id search removed and replaced with post-search

      api-operation-id-removed

    • ○

      the endpoint scheme security ApiKeyAuth was removed from the API

      api-security-removed

    • ○

      api tag search added

      api-tag-added

    • ○

      added Pagination subschema #2 to the response body allOf list for the response status 200

      response-body-all-of-added

    • ○

      added the media type application/json for the response with the status 400

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 401

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 404

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 429

      response-media-type-added

    • ○

      added the media type application/json for the response with the status 500

      response-media-type-added

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • f80fb2a115ff6054See the full diff
    • ▲

      request body became required

      request-body-became-required

    • ▲

      the request property headquarters/exclude/items/city became not nullable

      request-property-became-not-nullable

    • ▲

      the request property headquarters/exclude/items/state became not nullable

      request-property-became-not-nullable

    • ▲

      the request property headquarters/include/items/city became not nullable

      request-property-became-not-nullable

    • ▲

      the request property headquarters/include/items/state became not nullable

      request-property-became-not-nullable

    • ▲

      removed the enum value agriculture of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value b2b of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value b2c of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value bootstrapped of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value colleges_and_universities of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value commercial_and_residential_services of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value consumer_product_and_retail of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value content_and_publishing of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value directory of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value distributor of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value early_stage_funding of the request property funding_stage/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value education of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value education of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value electronics of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value finance of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value government of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value government of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value hardware of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value healthcare of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value hospitality_and_leisure of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value hospitals_and_medical_centers of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value industrials of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value information_technology of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value investment_banks_and_business_brokers of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value investor_backed of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value job_site of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value late_stage_funding of the request property funding_stage/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value manufacturer of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value marketplace of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value media of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value nonprofit_and_associations of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value other_funding of the request property funding_stage/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value pre_ipo_funding of the request property funding_stage/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_equity of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_equity_add_on of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_equity_and_venture_capital of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_equity_backed of the request property funding_stage/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_schools of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value private_subsidiary of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value producer of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value professional_services of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value public of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value public_subsidiary of the request property ownership/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value religious_institutions of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value retailer of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value services of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value software of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value software_enabled of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value staffing_and_recruiting of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value transportation of the request property end_customer/items/

      request-property-enum-value-removed

    • ▲

      removed the enum value us_federal_agencies of the request property business_models/items/

      request-property-enum-value-removed

    • ▲

      the employees_on_professional_networks_range/items/ request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the funding_size/items/ request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the grata_employees_estimates_range/items/ request property type/format changed from number/ to integer/

      request-property-type-changed

    • ▲

      the year_founded/items/ request property type/format changed from number/ to integer/

      request-property-type-changed

    • ●

      deleted the header request parameter Content-Type

      request-parameter-removed

    • ●

      removed the request property company_uid

      request-property-removed

    • ●

      removed the request property domain

      request-property-removed

    • ●

      removed the optional property company from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property results from the response with the 200 status

      response-optional-property-removed

    • ○

      api operation id post-search removed and replaced with search

      api-operation-id-removed

    • ○

      the endpoint scheme security ApiKeyAuth was added to the API

      api-security-added

    • ○

      added the new optional request property headquarters/include/items/example

      new-optional-request-property

    • ○

      added the optional property companies to the response with the 200 status

      response-optional-property-added

    This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 29fbf7a6e1061See the full diff
    • ●

      deleted the header request parameter Authorization

      request-parameter-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog