## JSON

**post** `/generate/json`

Fetches URL content, extracts data, and transforms it using AI based on custom instructions. Use this to generate new content, summaries, or restructured data.

### Body Parameters

- `instructions: string`

  Instructions describing how to transform the data. Maximum 20,000 characters.

- `json_schema: unknown`

  JSON schema defining the structure of the transformed output

- `url: string`

  URL to fetch content from

- `effort: optional "min" or "standard" or "max"`

  Fetch effort level controlling speed vs. capability tradeoff. "min": fastest, no fallback (1-5s). "standard": balanced with enhanced reliability (default, 3-15s). "max": full browser rendering for JS-heavy sites (15-60s).

  - `"min"`

  - `"standard"`

  - `"max"`

- `geo_target: optional GeotargetGeoTarget`

  Optional geotargeting parameters for proxy requests

  - `country: optional string`

    Country code using ISO 3166-1 alpha-2 standard (2 letters, e.g., "US", "GB", "JP").
    See: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

- `nocache: optional boolean`

  Bypass cache and force fresh data retrieval

### Example

```http
curl https://api.tabstack.ai/v1/generate/json \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $TABSTACK_API_KEY" \
    --max-time 300 \
    -d '{
          "instructions": "For each story, categorize it (tech/business/science/other) and write a one-sentence summary describing the story in simple terms.",
          "json_schema": {
            "properties": {
              "summaries": {
                "items": {
                  "properties": {
                    "category": {
                      "description": "Story category (tech/business/science/etc)",
                      "type": "string"
                    },
                    "summary": {
                      "description": "One-sentence summary of the story",
                      "type": "string"
                    },
                    "title": {
                      "description": "Story title",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              }
            },
            "type": "object"
          },
          "url": "https://news.ycombinator.com",
          "effort": "standard"
        }'
```

#### Response

```json
{
  "foo": "bar"
}
```