topic Query field in v3 search API in APIs & Integrations

Query field in v3 search API

nstansby — Thu, 28 May 2020 16:16:56 GMT

I am trying to use the v3 search API (/crm/v3/objects/contacts/search). I've been struggling to understand the query field... I haven't been able to find any documentation on it, or examples. It seems the combination of the properties and filterGroups fields in the request specifiy what records you want, and what properties you want to retrieve, so what is the purpose of the query field? And can anyone point me at an example of how to use it?

I'm new to HubSpot and decided to dive directly into the v3 API; maybe this is a concept carried over from earlier versions of the API?

Re: Query field in v3 search API

WendyGoh — Fri, 29 May 2020 07:12:45 GMT

Hey @nstansby,

Welcome to HubSpot 🙂

The query will search based on the default searchable properties (mentioned on this documentation: CRM API | Search) i.e. for contacts, it would be firstname, hs_additional_emails, phone, hs_object_id, hs_searchable_calculated_phone_number, company, email and lastname.

Re: Query field in v3 search API

nstansby — Fri, 29 May 2020 14:18:09 GMT

Thanks @WendyGoh , I'd just been looking at the endpoint documentation. The link you sent is exactly what I needed.

Re: Query field in v3 search API

kawyns1 — Fri, 09 Oct 2020 12:48:40 GMT

Hi @WendyGoh ,

I have a similar use case where i want to filter by the lastmodifieddate property to get the tickets records since the last timestamp. Is it possible to get this data from the search crm api?

Re: Query field in v3 search API

WendyGoh — Mon, 12 Oct 2020 08:22:19 GMT

Hey @kawyns1,

This is possible via the HubSpot CRM API | Search. You can do something like this:

curl https://api.hubapi.com/crm/v3/objects/contacts/search?hapikey=YOUR_HUBSPOT_API_KEY \ --request POST \ --header "Content-Type: application/json" \ --data '{ "filterGroups":[ { "filters":[ { "propertyName": "lastmodifieddate", "operator": "EQ", "value": "{{timestamp here}}" } ] } ] }

Re: Query field in v3 search API

Spark-Y — Fri, 16 Jul 2021 11:28:56 GMT

Can anyone give some examples for the PHP in curl ?

Re: Query field in v3 search API

Long_Nguyen — Fri, 26 Nov 2021 08:44:25 GMT

Hi @WendyGoh

Is this API available via URL in the browser? Can you please give me an example of URL rather than curl?

For example, with API version 1, in order to list all contacts with specific properties I can paste in the browser with the following URL.

https://api.hubapi.com/contacts/v1/lists/all/contacts/all?hapikey=YOUR_HUBSPOT_API_KEY&count=15&&propertyMode=value_and_history&property=YOURPROPERTIES

Re: Query field in v3 search API

BEAutoBot — Fri, 10 Mar 2023 21:19:55 GMT

This is the correct answer and contains the important structure of the neccessary query object. Thank you.

Re: Query field in v3 search API

christran — Thu, 03 Apr 2025 04:22:56 GMT

Man, this document is crazy. That thing should be documented in below section instead of letting developers struggle to search for answer in Google.

https://developers.hubspot.com/docs/reference/api/crm/engagements/email