---
title: "documents_search (DocumentCloud)"
description: "Search Document"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/documentcloud/DocumentCloud.DocumentCloud.documents_search
original: https://documentation.invantive.eu/en/datamodels/documentcloud/DocumentCloud.DocumentCloud.documents_search
updated: 2026-11-16T20:48:12Z
license: https://documentation.invantive.eu/en/
---

# documents_search: DocumentCloud Search Document

`read only` `REST`

- Catalog: `DocumentCloud`
- Schema: `DocumentCloud`
- Primary Keys: `id`
- Label: Search Document

Can only retrieve data.

## API Source

- Endpoint: `/documents/search?q={query}&sections=false&annotations=false&data=false&mentions=false`

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `query` | `varchar2` | [x] |  | Search query in terms by Solr. See also https://www.documentcloud.org/help/search/. |

## Table Columns

The columns of the table `documents_search` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `access` | `varchar2` |  | [ ] |  | The access level for the document. Defaults to 'private'. |
| `asset_url` | `varchar2` |  | [ ] |  | The base URL to load this document’s static assets from. |
| `canonical_url` | `varchar2` |  | [ ] |  | The canonical URL to view this document. |
| `created_at` | `datetime` |  | [ ] |  | Time stamp when this document was created. |
| `description` | `varchar2` |  | [ ] |  | A brief description of the document. |
| `edit_access` | `char` |  | [x] |  | Does the current user have edit access to this document. |
| `file_hash` | `varchar2` |  | [ ] |  | File hash. |
| `file_url` | `varchar2` |  | [ ] |  | A URL to a publicly accessible document for the URL Upload Flow. |
| `force_ocr` | `char` |  | [ ] |  | Force OCR even if the PDF contains embedded text - only include if file_url is set, otherwise should set force_ocr on the call to the processing endpoint. |
| `id` | `int64` |  | [x] |  | The ID for the document. |
| `language` | `varchar2` |  | [ ] |  | The language the document is in. Defaults to 'eng'. |
| `organization` | `int64` |  | [x] |  | The ID for the organization this document belongs to. |
| `original_extension` | `varchar2` |  | [ ] |  | Original file extension. |
| `page_count` | `int32` |  | [ ] |  | The number of pages in this document. |
| `page_spec` | `varchar2` |  | [ ] |  | The dimensions for all pages in the document. |
| `presigned_url` | `varchar2` |  | [ ] |  | The pre-signed URL to directly PUT the PDF file to. |
| `publish_at` | `datetime` |  | [ ] |  | A timestamp when to automatically make this document public. |
| `published_url` | `varchar2` |  | [ ] |  | The URL where this document is embedded. |
| `related_article` | `varchar2` |  | [ ] |  | The URL for the article about this document. |
| `slug` | `varchar2` |  | [ ] |  | The slug is a URL safe version of the title. |
| `source` | `varchar2` |  | [ ] |  | The source who produced the document. |
| `status` | `varchar2` |  | [ ] |  | The status for the document. |
| `title` | `varchar2` |  | [ ] |  | The document's title. |
| `updated_at` | `datetime` |  | [ ] |  | Time stamp when the document was last updated. |
| `user` | `int64` |  | [x] |  | The ID for the user this document belongs to. |

