v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-056151218.0 KB

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.

post/generate/json

Request body

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

instructionsstring required

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

json_schemaobject required

JSON schema defining the structure of the transformed output

nocacheboolean

Bypass cache and force fresh data retrieval

urlstring uri required

URL to fetch content from

Example request

{
  "effort": "standard",
  "geo_target": {
    "country": "US"
  },
  "instructions": "For each story, categorize it (tech/business/science/other) and write a one-sentence summary explaining what it's about 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"
}

Response

V1GenerateJSONResponse required