MarkUDown

API Prompt Extract — documentação da extração de dados com LLM MarkUDown

POST/api/prompt-extract

Extração por prompt (Prompt Extract)

Extraia dados de uma página com uma instrução em linguagem natural — sem schema. O LLM escolhe os nomes dos campos e devolve uma lista de objetos JSON.

ParâmetroTipoObrigatórioPadrãoDescrição
urlstringobrigatório—URL da página de onde extrair.
promptstringobrigatório—O que extrair, em linguagem natural.
main_contentbooleanopcionaltrueExtrai só o conteúdo principal (descarta navegação, cabeçalho e rodapé).
timeoutintegeropcional60Tempo limite de carregamento da página, em segundos.
callback_urlstringopcionalnullURL de webhook que recebe o resultado (POST) quando o job termina.

Requisição

curl -X POST https://api.scrapetechnology.com/api/prompt-extract \
  -H "X-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://quotes.toscrape.com/", "prompt": "Every quote with its author and tags"}'

Resposta

// POST returns { "success": true, "id": "abc123", "url": "/api/extract/abc123" }
// Poll GET /api/extract/{id}
{
  "success": true,
  "id": "abc123",
  "status": "completed",
  "data": {
    "success": true,
    "data": [
      {
        "quote": "The world as we have created it is a process of our thinking...",
        "author": "Albert Einstein",
        "tags": ["change", "deep-thoughts", "thinking", "world"]
      }
    ],
    "total": 1,
    "url": "https://quotes.toscrape.com/",
    "processing_time_ms": 5400
  }
}

Python — pip install markudown

from markudown import MarkUDown

md = MarkUDown(api_key="your-api-key")
job = md.prompt_extract("https://quotes.toscrape.com/", "Every quote with its author and tags")
print(job["data"]["data"])

Node.js — npm install markudown-sdk

import { MarkUDown } from "markudown-sdk";

const md = new MarkUDown({ apiKey: "your-api-key" });
const job = await md.promptExtract("https://quotes.toscrape.com/", "Every quote with its author and tags");
console.log(job.data.data);
Jobs do Prompt Extract são consultados em GET /api/extract/{id} (não em /api/prompt-extract). Só os primeiros 50.000 caracteres do Markdown da página são enviados ao LLM.

Custo: 5 créditos por requisição.