Buyer Intent

Browse buyer intent interactions (product-agnostic)

Changed on

Requires buyer_intent.read scope.

Query buyer intent data across one or more products in a single request. Pass product_id to specify which products, or omit to use your assigned products. Supports multi-product queries — the data is not scoped to a single subject product.

get/api/v2/buyer_intent

Request

  • Base URL: https://data.g2.com
  • URL: https://data.g2.com/api/v2/buyer_intent
  • Auth: HTTP bearer and OAuth 2 (authorization code, authorization URL https://www.g2.com/oauth/authorize, token URL https://www.g2.com/oauth/token, scopes: openid, profile)

Query parameters

dimensionsstring[]

Comma separated list of dimensions

measuresstring[]

Comma separated list of measures

subject_product_idsstring

One or more product IDs, UUIDs, or URL slugs (comma-separated) that scope the permissions of this query. Defaults to your assigned products.

sortstring

Sort field with optional direction prefix. Use "-" for descending (e.g., "-day")

page[size]integer

Number of records per page (default: 25, max: 250)

page[after]string

Cursor for fetching the next page of results

page[before]string

Cursor for fetching the previous page of results

dimension_filtersobject

Filters represented as query object (e.g., dimension_filters[company_name_cont]=Acme)

{
  "company_name_cont": "Acme",
  "provider_in": "g2",
  "audience_product_id_in": "<product-uuid-or-slug>"
}

Response

Successful responses

Changes

  • 4eb7e23e2a6dRevision changes
    • breaking

      for the query request parameter page[size], default value 25 was added

    • warning

      for the query request parameter page[size], the max was set to 250.00

    • warning

      for the query request parameter page[size], the min was set to 1.00

    • info

      added the new optional query request parameter page[after]

    • info

      added the new optional query request parameter page[before]