## JSON

`client.generate.json(GenerateJsonParamsbody, RequestOptionsoptions?): GenerateJsonResponse`

**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.

### Parameters

- `body: GenerateJsonParams`

  - `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?: "min" | "standard" | "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?: GeotargetGeoTarget`

    Optional geotargeting parameters for proxy requests

    - `country?: 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?: boolean`

    Bypass cache and force fresh data retrieval

### Returns

- `GenerateJsonResponse = Record<string, unknown>`

### Example

```typescript
import Tabstack from '@tabstack/sdk';

const client = new Tabstack({
  apiKey: process.env['TABSTACK_API_KEY'], // This is the default and can be omitted
});

const response = await client.generate.json({
  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',
});

console.log(response);
```

#### Response

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