Developer quickstart

Introduction

Sensible extracts structured data from documents, for example PDFs of business forms, using SenseML, a JSON-formatted query language. Write SenseML to extract from your custom documents, or leverage our open-source SenseML configuration library for common business document types.

In this quickstart, use an example SenseML configuration and example PDF to get a quick "hello world" API response.

Extract example document data

To run an API call and return extracted, structured data from a downloaded example document:

  1. Get an account at sensible.so.

    NOTE In the Sensible app, don't rename of the default doc type (senseml_basics) or delete the 1_extract_your_first_data config, or this example fails.

  2. Copy your API key from your account page.

  3. Copy the following code example into a plain-text application and replace <YOUR_API_TOKEN> with your API key:

curl -L https://github.com/sensible-hq/sensible-docs/raw/main/readme-sync/assets/v0/pdfs/1_extract_your_first_data.pdf \
  --output 1_extract_your_first_data.pdf && \
curl --request POST \
  --url "https://api.sensible.so/v0/extract/senseml_basics" \
  --header "Authorization: Bearer <YOUR_API_TOKEN>" \
  --header "Content-Type: application/pdf" \
  --data-binary "@1_extract_your_first_data.pdf"
curl -L https://github.com/sensible-hq/sensible-docs/raw/main/readme-sync/assets/v0/pdfs/1_extract_your_first_data.pdf ^
  --output 1_extract_your_first_data.pdf && ^
curl --request POST ^
  --url "https://api.sensible.so/v0/extract/senseml_basics" ^
  --header "Authorization: Bearer <YOUR_API_TOKEN>" ^
  --header "Content-Type: application/pdf" ^
  --data-binary "@1_extract_your_first_data.pdf"
  1. Run the code sample in a command prompt. The code downloads an example PDF (1_extract_your_first_data.pdf ) and runs it against an example document type (senseml_basics). The following excerpt of the API response shows the extracted document text in the parsed_document object:
{
   "parsed_document":{
      "your_first_extracted_field":{
         "type":"string",
         "value":"Welcome to your first document"
      }
   }
}

(Optional) See how it works in the Sensible app

To see this example in the Sensible app:

  1. Log into the Sensible app.

  2. Navigate to the first tutorial config.

  3. Visually examine the example PDF (middle pane), config (left pane), and extracted data (right pane) to better understand the API call you just ran:

qq

Next


Did this page help you?