Search API: Full-Text Query, Filters, and Pagination

Use GET /v1/search to run full-text queries with field filters, ISO 8601 date ranges, sort options, and pagination across all your data objects.

The Search API gives you a powerful, flexible way to find exactly what you need across all of the data objects in your account. Whether you are building an in-app search experience, running automated audits, or surfacing relevant records for your users, the /v1/search endpoint accepts full-text queries alongside a rich set of filters — including field-level expressions, ISO 8601 date ranges, and configurable sorting — so you can narrow results precisely and paginate through large datasets with ease.

GET /v1/search

Retrieve a paginated list of data objects that match your query and filter criteria.

Query Parameters

q · string · required

The full-text search query string. Matches against titles, content, and indexed metadata fields across all data objects in your account.

filter · string

A field-level filter expression in field:value format. Use this to restrict results to a specific type or attribute — for example, type:document returns only document objects. Multiple filters are not yet supported in a single request.

from · string

An ISO 8601 timestamp. When provided, only results created on or after this date and time are returned. Example: 2024-01-01T00:00:00Z.

to · string

An ISO 8601 timestamp. When provided, only results created on or before this date and time are returned. Example: 2024-12-31T23:59:59Z.

sort · string · default: "relevance"

The field by which results are ordered. Accepted values:

• relevance — orders by computed relevance score (default)
• date — orders by creation date, newest first
• title — orders alphabetically by title

page · integer · default: "1"

The page number to retrieve. Starts at 1. Use in combination with limit to paginate through result sets.

limit · integer · default: "20"

The number of results to return per page. Minimum is 1, maximum is 100. Defaults to 20.

Example Request

cURL

curl 'https://api.google.com/v1/search?q=annual+report&filter=type:document&sort=date&limit=10' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "data": {
    "results": [
      {
        "id": "dat_1a2b3c",
        "title": "Annual Report 2024",
        "type": "document",
        "score": 0.94,
        "created_at": "2024-01-15T09:00:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "pages": 1
  },
  "meta": { "request_id": "req_xyz789" }
}

Response Fields

results · array

An array of data objects that match your query and filter criteria, ordered according to the sort parameter.

Show results[]

id · string

The unique identifier for the data object, prefixed with dat_.

title · string

The human-readable title of the data object as set when it was created or last updated.

type · string

The object type. Possible values are document, note, and record.

score · number

A relevance score between 0 and 1 indicating how closely the item matches your query. Higher values indicate stronger matches. Only meaningful when sort=relevance.

created_at · string

The ISO 8601 timestamp at which the data object was created, in UTC.

total · integer

The total number of data objects that match your query and filter criteria across all pages.

page · integer

The current page number returned in this response, corresponding to the page query parameter you supplied.

pages · integer

The total number of pages available given the current limit and total result count.

Newly created or updated data objects may take up to 30 seconds to appear in search results. If you do not see a recently created item, wait a moment and retry your query before assuming it is missing.