There are four ways to upload content GroundX via API:
Of the endpoints which concern files, the currently supported file types are:
And the currently supported image types are:
If you are a free trial user, restrictions on document ingestion per-file include:
python SDK:
TypeScript SDK:
If you are a subscription user, restrictions on document ingestion per-file include:
python SDK:
TypeScript SDK:
ingest_remote. This bypasses the 8 MB cap that applies to direct calls to ingest_local. The TypeScript SDK and direct REST callers can use the same pattern manually: request a pre-signed URL from https://api.eyelevel.ai/upload/file?name={fileName}&type={fileExtension}, PUT the file bytes to the returned URL, and submit the resulting hosted URL as the sourceUrl in an ingest_remote call. The MCP server does not expose a tool for local-file uploads, so MCP clients must use this same pattern.If you have files that are larger than the allowable file size limit, we recommend compressing assets (like images) within the file or dividing the file into several smaller files.
Ingest Directories has the same per-file ingest constraints as Ingest Local.
There is a restriction of a maximum 50 files being concurrently ingested at a time.
The Ingest Directories function in the Python SDK automatically handles batching uploads based on the batch_size parameter. Otherwise, batching can be done by using get_processing_status_by_id to wait for an uploaded batch to complete, as described in the Quickstart.
Maximum Pages
For document types with pages including: PDF, PPTX, DOCX, and HWP, there is a restriction of a maximum 750 pages.
Maximum Words
For document types without pages including: CSV, TSV, and XLSX, there is a restriction of a maximum of 250,000 words for trial users and 500,000 words for subscription users.
Maximum Rows
For document types with rows including: CSV, TSV, and XLSX, there is a restriction of a maximum 1,500 lines.
Maximum Words
For raw text files, there is a restriction of a maximum of 250,000 words for trial users and 500,000 words for subscription users.
Maximum File Size
For JSON files, there is a maximum 5 MB file size restriction. This restriction is specific JSON files and supercedes the file size restrictions described above.
Maximum Levels
For JSON files, there is a maximum 20 levels of nesting for any JSON object. This refers to dictionaries or arrays with nested dictionaries or arrays.
Processed documents of every supported document type include an x-ray analysis that is accessible via API and can be downloaded in the dashboard.
Some documents types do not go through the visual layout analysis pipeline and, therefore, are not viewable in the visual x-ray viewer in the dashboard. The document types that ARE NOT viewable in the x-ray viewer in the dashboard are:
The GroundX ingestion pipeline can also crawl and ingest the content from websites using the Crawl Website endpoint.
For trial users, a maximum of 500 pages is supported, with a maximum crawl depth of 5 pages. For subscribers, a maximum of 2,000 pages at a crawl depth of 8 is supported.