---
title: "Retrieve buyer intent signals for a date range"
method: GET
path: "/api/v2/market_signals"
tags: ["Market Signals"]
---

# Retrieve buyer intent signals for a date range

`GET /api/v2/market_signals`

**Requires `market_signals.read` scope.**

Retrieve buyer intent signals (interactions) for specific categories.

Returns one result per buyer intent interaction within the specified date range.
Each interaction includes the category UUID, company name, and domain.

If no dates are provided, defaults to today for both start and end date.

Results are paginated using cursor-based pagination (default 25, max 250 per page).

## Query parameters

- `category_ids[]` string[], required
- `start_date` string, date
- `end_date` string, date
- `page[size]` integer
- `page[after]` string
- `page[before]` string

## Response `200`

Signals retrieved successfully

- object
  - `data` object[], required
    - `type` 'market_signals', required
    - `attributes` object, required
      - `category_uuid` string, required
      - `company_name` string, required
      - `company_domain` string, required
      - `start_date` string, date, required
      - `end_date` string, date, required

## Other responses

- `400` — Invalid parameters
- `404` — Category not found

## Changes

- **2026-08-12** `4eb7e23e2a6d` — 1 breaking, 1 info
  - for the `query` request parameter `page[size]`, default value `25` was added
  - for the `query` request parameter `page[size]`, the max was increased from `100.00` to `250.00`

[Change history](https://skmtc.dev/g2/apis/g2-api/changes/api/v2/market_signals/get.md)

---

[API](https://skmtc.dev/g2/apis/g2-api.md) · [All operations](https://skmtc.dev/g2/apis/g2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g2/g2-api/revisions/63b15460479c/schema)