Pular para o conteúdo principal
POST
/
extract
Extraia dados estruturados de páginas da web usando LLMs
curl --request POST \
  --url https://api.firecrawl.dev/v2/extract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ],
  "prompt": "<string>",
  "schema": {},
  "enableWebSearch": false,
  "ignoreSitemap": false,
  "includeSubdomains": true,
  "showSources": false,
  "scrapeOptions": {
    "formats": [
      "markdown"
    ],
    "onlyMainContent": true,
    "includeTags": [
      "<string>"
    ],
    "excludeTags": [
      "<string>"
    ],
    "maxAge": 172800000,
    "headers": {},
    "waitFor": 0,
    "mobile": false,
    "skipTlsVerification": true,
    "timeout": 123,
    "parsers": [
      "pdf"
    ],
    "actions": [
      {
        "type": "wait",
        "milliseconds": 2,
        "selector": "#my-element"
      }
    ],
    "location": {
      "country": "US",
      "languages": [
        "en-US"
      ]
    },
    "removeBase64Images": true,
    "blockAds": true,
    "proxy": "auto",
    "storeInCache": true
  },
  "ignoreInvalidURLs": true
}
'
{
  "success": true,
  "id": "<string>",
  "invalidURLs": [
    "<string>"
  ]
}

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
​
urls
string<uri>[]
obrigatório

As URLs das quais os dados serão extraídos. As URLs devem estar no formato glob.

​
prompt
string

Prompt para guiar o processo de extração

​
schema
object

Esquema que define a estrutura dos dados extraídos. Deve estar em conformidade com o JSON Schema.

​
enableWebSearch
boolean
padrão:false

Quando definido como true, a extração usará busca na web para encontrar dados adicionais

​
ignoreSitemap
boolean
padrão:false

Quando definido como true, arquivos sitemap.xml serão ignorados durante a varredura do site

​
includeSubdomains
boolean
padrão:true

Quando definido como true, os subdomínios das URLs fornecidas também serão rastreados

​
showSources
boolean
padrão:false

Quando definido como true, as fontes usadas para extrair os dados serão incluídas na resposta sob a chave sources

​
scrapeOptions
object
​
ignoreInvalidURLs
boolean
padrão:true

Se URLs inválidas forem especificadas no array urls, elas serão ignoradas. Em vez de fazer com que a requisição inteira falhe, será feita uma extração usando as URLs válidas restantes, e as URLs inválidas serão retornadas no campo invalidURLs da resposta.

Resposta

Extração bem-sucedida

​
success
boolean
​
id
string
​
invalidURLs
string[] | null

Se ignoreInvalidURLs for true, este será um array contendo as URLs inválidas especificadas na requisição. Se não houver URLs inválidas, será um array vazio. Se ignoreInvalidURLs for false, este campo será undefined.