Skip to main content
Try it live: PDF to JSON with AI → API Tester — send a real request from your browser.

POST /v1/pdf/convert/to/json-meta

This endpoint can also be used with a specified profile to extract image data from a PDF into your JSON output.
What is the difference between /pdf/convert/to/json-meta and /pdf/convert/to/json2? /pdf/convert/to/json-meta uses AI to detect meta styles for text objects, such as:
  • paragraph style (from h1 .. h7 to p and small).
  • meta type of the text object (text, datetime, integer, decimal, currency etc.).
  • meta subType of the text object (companyName, personName and other AI-based meta types).
  • /json-meta consumes more credits because it runs with AI.
  • /json-meta is also a bit slower due to the AI process. Async mode is recommended for this endpoint.
Convert PDF and scanned images into JSON using AI.

Attributes

Attributes are case-sensitive and should be inside JSON for POST request. for example: { "url": "https://example.com/file1.pdf" }
You can use profiles to control the convert process and output of the CSV file.

Line Grouping Options

  • "1": GroupByRows – Each row is checked against the next row to see if they can be grouped together. Rows will only be grouped if all cells in the current row can be grouped with all cells in the next row. Useful when merging related content that spans multiple lines but belongs to the same logical row.
  • "2": GroupByColumns – Each cell is checked against the cell below it in the next row to determine if they can be grouped. Cells are grouped within the same column even if others can’t be grouped. Useful for columnar data where content in each column might span multiple lines.
  • "3": JoinOrphanedRows – Joins a row with a single cell to the previous row if there is no separator between them. Useful for handling cases with orphaned or misaligned content.

OCRImagePreprocessingFilters

To set image preprocessing filters, please use:

Query parameters

No query parameters accepted.

Responses

Example Payload

To see the request size limits, please refer to the Request Size Limits.

Example Response

To see the main response codes, please refer to the Response Codes page.
Inconsistent URL Encoding in cURL Output: When using cURL to make API requests, the output JSON may show URL characters encoded as Unicode escape sequences. For example, the ampersand character (&) may appear as \u0026 in the cURL output. This is normal JSON encoding behavior and does not affect the validity of the URL. The URL will function correctly when used, as JSON parsers automatically decode these escape sequences. If you’re parsing the response programmatically, your JSON parser will handle this conversion automatically.

Code Samples