> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odella.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract JSON Block

> Extract JSON data from a string input

<Frame>
  <img src="https://mintcdn.com/odella/I7v1Fbrp2kx7rLoj/block-reference/assets/extract_json_light.png?fit=max&auto=format&n=I7v1Fbrp2kx7rLoj&q=85&s=e2d6606c918ac332cd15b050f3b3dbc3" alt="Extract JSON Block Screenshot" className="block dark:hidden" width="868" height="324" data-path="block-reference/assets/extract_json_light.png" />

  <img src="https://mintcdn.com/odella/I7v1Fbrp2kx7rLoj/block-reference/assets/extract_json_dark.png?fit=max&auto=format&n=I7v1Fbrp2kx7rLoj&q=85&s=1b2617b7172b6d338f8e2f1c758d3112" alt="Extract JSON Block Screenshot" className="hidden dark:block" width="842" height="336" data-path="block-reference/assets/extract_json_dark.png" />
</Frame>

## Overview

The Extract JSON Block finds and parses the first JSON object or array in the input text. It attempts to locate JSON data between curly braces `{}` or square brackets `[]` and parse it into a JavaScript object.

## Inputs

<ParamField path="input" type="string" required>
  The input string containing JSON data to be extracted. The block will search for the first valid JSON object or array in this string.
</ParamField>

## Outputs

<ResponseField name="output" type="object">
  The extracted and parsed JSON data as a JavaScript object. If no valid JSON is found or parsing fails, this output will be control-flow-excluded.
</ResponseField>

<ResponseField name="noMatch" type="string">
  If no valid JSON could be parsed, this output will contain the original input string. If JSON was successfully parsed, this output will be control-flow-excluded.
</ResponseField>

## Example: Extracting JSON from Text

1. Add an Extract JSON block to your flow
2. Connect a string containing JSON data to the input
3. The block will attempt to find and parse the first JSON object
4. If successful, the parsed object will be available at the `output` port
5. If unsuccessful, the original string will be available at the `noMatch` port

## Error Handling

* If no valid JSON is found or if parsing fails, the `output` port will be control-flow-excluded and the original input string will be available at the `noMatch` port
* If valid JSON is found and parsed successfully, the `noMatch` port will be control-flow-excluded and the parsed object will be available at the `output` port

## FAQ

<AccordionGroup>
  <Accordion title="What types of JSON structures can be extracted?">
    The block can extract both JSON objects (enclosed in curly braces {}) and JSON arrays (enclosed in square brackets \[]). It will find the first occurrence of either structure in the input string.
  </Accordion>

  <Accordion title="What happens if there are multiple JSON objects in the input?">
    The block will only extract the first valid JSON object or array it finds in the input string. Subsequent JSON objects will be ignored.
  </Accordion>

  <Accordion title="How does the block handle invalid JSON?">
    If the block cannot parse valid JSON from the input string, it will output the original string to the `noMatch` port and control-flow-exclude the `output` port.
  </Accordion>
</AccordionGroup>

## See Also

* [Object Block](/block-reference/data/object)
* [HTTP Call Block](/block-reference/advanced/http-call)