1eye Docs – Buyer Signals API, Webhooks, MCP & Integrations

Use this tool to find existing buyer records. See Search & Pagination for every supported field and operator. To inspect activity during a period, use Search Signals. The examples below are MCP tool arguments. Replace uppercase IDs with values returned by your workspace.

`search_buyers`

Read-only Search buyer records by company and person attributes, attribution, fit, signal counts, and dates. A buyer’s signal counts are lifetime record attributes. They do not restrict those signals to the buyer-creation date range in your query.

Arguments

Argument	Type	Required	Description
`filter`	object	No	Rule group. See the complete buyer filter reference.
`limit`	number	No	Page size; defaults to 25.
`cursor`	string	No	Continuation cursor from this search.
`sort_order`	`asc` or `desc`	No	Oldest or newest first; defaults to `desc`.

Example

{
  "filter": {
    "match": "all",
    "rules": [
      {
        "field": "is_icp",
        "operator": "eq",
        "value": true
      },
      {
        "field": "has_verified_email",
        "operator": "eq",
        "value": true
      }
    ]
  },
  "limit": 10
}

Returns: A paginated payload with total, data, next_cursor, and applied_filter. Buyer records include contact_info, company_info, matches, signal counts, attribution, and first/last signal references.