Skip to main content

Next Steps

If you have already started GROBID and made at least one successful request, this page helps you choose the right next document instead of wandering through the sidebar.

If you just got your first successful result​

Start here:

This path is best if you are still learning what GROBID returns and how to reason about TEI output.

If you want to make more API requests correctly​

Go here:

Use this path if you want to:

  • call other endpoints
  • understand parameters
  • interpret responses correctly
  • build a client integration

If startup or requests fail​

Go here:

Use Docker troubleshooting when the problem is:

  • container startup
  • mounts
  • shell syntax
  • platform-specific Docker behavior

Use the general troubleshooting page when the problem is:

  • request failures
  • empty or partial output
  • 503, timeout, or input errors

If you want to change behavior safely​

Go here:

Use this path when you want to:

  • enable consolidation
  • change ports
  • tune concurrency
  • adjust parser limits
  • understand grobid.yaml

If you want metadata enrichment​

Go here:

Use this path when you want to understand:

  • CrossRef vs biblio-glutton
  • offline vs online behavior
  • why metadata may change after enrichment
  • throughput trade-offs caused by consolidation

If you want to process many PDFs​

Go here:

Use this path when one request is no longer enough and you need to think about:

  • concurrency
  • retries
  • throughput
  • CPU vs full image trade-offs

If the default processing does not fit your documents​

Go here:

Use this when you are working with:

  • article-adjacent documents such as corrections or letters
  • standards/specification documents
  • specialized processing variants rather than normal scholarly-article defaults

A simple decision guide​

Your situationBest next page
I got a result but do not understand the XMLUnderstanding the Output
I need another endpoint or parameterREST API Usage
Docker startup failedDocker Troubleshooting
I want to change config safelyConfiguration Guide
I want more metadata enrichmentConsolidation
I want to process many PDFsBatch Processing
I need better throughput or stability under loadPerformance Tuning
Default processing is the wrong shape for my documentsProcessing Flavors

If you are not sure what to do next, this is a good sequence:

  1. Your First Extraction
  2. Understanding the Output
  3. REST API Usage
  4. Configuration Guide
  5. Batch Processing

That path usually gets users from first success to real usage with the least confusion.