Mastering the Pandas DataFrame to_json() Function: A Comprehensive Guide

When working with data in Python, the Pandas library stands out as a powerful tool for data manipulation and analysis. One of the many functionalities Pandas provides is the ability to convert DataFrames to various formats, and JSON (JavaScript Object Notation) is one of the most widely used formats for data exchange. In this blog post, we'll explore the to_json() function in Pandas, guiding you through its usage, parameters, and providing examples to help you understand how to effectively use this function in your data science projects.

Introduction to JSON Format

link to this section

JSON is a lightweight data interchange format that is easy to read and write for humans, and easy to parse and generate for machines. It represents data as key-value pairs and is widely used in web development and data exchange between a server and a client.

The to_json() Function in Pandas

link to this section

Pandas provide the to_json() function, which allows you to convert a DataFrame into a JSON formatted string. The function comes with various parameters, giving you control over how the data is converted and formatted.

Basic Usage

link to this section

The most basic usage of the to_json() function is calling it on a DataFrame object. By default, the function converts the DataFrame into a JSON string with a column-oriented format.

import pandas as pd 
data = {'Name': ['John', 'Anna'], 
    'Age': [28, 24], 
    'City': ['New York', 'Paris']} 

df = pd.DataFrame(data) 
json_data = df.to_json() 

In this example, the DataFrame df is converted into a JSON formatted string and stored in the variable json_data .

Formatting Options

link to this section

The to_json() function provides several parameters to customize the output.


The orient parameter controls the format of the JSON string. The options are:

  • 'split' : Dictionary containing indexes, columns, and data.
  • 'records' : List of dictionaries, each representing a row of data.
  • 'index' : Row-oriented format with dictionaries.
  • 'columns' : The default option, column-oriented format.
  • 'values' : Just the values in a 2D array.
json_data = df.to_json(orient='records') 


This parameter controls the formatting of datetime objects. The options are:

  • 'epoch' : The default, representing dates as UNIX timestamps.
  • 'iso' : ISO 8601 format.
df['Birthday'] = pd.to_datetime(['1993-05-31', '1998-03-10']) 
json_data = df.to_json(date_format='iso') 


This parameter controls the number of decimal places for floating point numbers.

df['Score'] = [90.23456, 85.12345] 
json_data = df.to_json(double_precision=2) 


link to this section

The to_json() function in Pandas is a versatile tool for converting DataFrames into JSON format. Understanding the various parameters and options allows you to tailor the function to your specific needs, ensuring that your data is formatted correctly for whatever application you need.

By following the examples and explanations provided in this blog post, you should now have a solid grasp of how to use the to_json() function in Pandas, making your data manipulation tasks in Python more efficient and effective. Happy coding!