PHP - Firecrawl Docs

Requisitos previos#

PHP 8.0+ con la extensión cURL
Una clave de la API de Firecrawl — obtén una gratis

Buscar en la web#

Firecrawl funciona con PHP a través de la API REST utilizando cURL.

<?php$apiKey = getenv('FIRECRAWL_API_KEY');$ch = curl_init('https://api.firecrawl.dev/v2/search');curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_HTTPHEADER => [        'Authorization: Bearer ' . $apiKey,        'Content-Type: application/json',    ],    CURLOPT_POSTFIELDS => json_encode([        'query' => 'firecrawl web scraping',        'limit' => 5,    ]),]);$response = curl_exec($ch);curl_close($ch);$results = json_decode($response, true);foreach ($results['data']['web'] as $result) {    echo $result['title'] . ' - ' . $result['url'] . "\n";}

Respuesta de ejemplo

{  "success": true,  "data": {    "web": [      {        "url": "https://docs.firecrawl.dev",        "title": "Firecrawl Documentation",        "markdown": "# Firecrawl\n\nFirecrawl is a web scraping API..."      }    ]  }}

Hacer scraping de una página#

<?php$ch = curl_init('https://api.firecrawl.dev/v2/scrape');curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_HTTPHEADER => [        'Authorization: Bearer ' . $apiKey,        'Content-Type: application/json',    ],    CURLOPT_POSTFIELDS => json_encode([        'url' => 'https://example.com',    ]),]);$response = curl_exec($ch);curl_close($ch);$data = json_decode($response, true);echo $data['data']['markdown'];

Respuesta de ejemplo

{  "success": true,  "data": {    "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",    "metadata": {      "title": "Example Domain",      "sourceURL": "https://example.com"    }  }}

Interactuar con una página#

Inicia una sesión del navegador, interactúa con la página utilizando prompts en lenguaje natural y luego cierra la sesión.

Paso 1 — Haz scraping para iniciar una sesión#

<?php$ch = curl_init('https://api.firecrawl.dev/v2/scrape');curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_HTTPHEADER => [        'Authorization: Bearer ' . $apiKey,        'Content-Type: application/json',    ],    CURLOPT_POSTFIELDS => json_encode([        'url' => 'https://www.amazon.com',        'formats' => ['markdown'],    ]),]);$response = curl_exec($ch);curl_close($ch);$scrapeResult = json_decode($response, true);$scrapeId = $scrapeResult['data']['metadata']['scrapeId'];echo "scrapeId: $scrapeId\n";

Paso 2 — Enviar las interacciones#

<?php$interactUrl = "https://api.firecrawl.dev/v2/scrape/$scrapeId/interact";$headers = [    'Authorization: Bearer ' . $apiKey,    'Content-Type: application/json',];// Buscar un producto$ch = curl_init($interactUrl);curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_HTTPHEADER => $headers,    CURLOPT_POSTFIELDS => json_encode([        'prompt' => 'Search for iPhone 16 Pro Max',    ]),]);$response = curl_exec($ch);curl_close($ch);echo $response . "\n";// Hacer clic en el primer resultado$ch = curl_init($interactUrl);curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_POST => true,    CURLOPT_HTTPHEADER => $headers,    CURLOPT_POSTFIELDS => json_encode([        'prompt' => 'Click on the first result and tell me the price',    ]),]);$response = curl_exec($ch);curl_close($ch);echo $response . "\n";

Paso 3 — Detener la sesión#

<?php$ch = curl_init($interactUrl);curl_setopt_array($ch, [    CURLOPT_RETURNTRANSFER => true,    CURLOPT_CUSTOMREQUEST => 'DELETE',    CURLOPT_HTTPHEADER => [        'Authorization: Bearer ' . $apiKey,    ],]);curl_exec($ch);curl_close($ch);echo "Sesión detenida\n";

Clase auxiliar reutilizable#

Si vas a usarla varias veces, encapsula la API en una clase:

<?phpclass Firecrawl{    private string $apiKey;    private string $baseUrl = 'https://api.firecrawl.dev/v2';    public function __construct(string $apiKey)    {        $this->apiKey = $apiKey;    }    private function post(string $endpoint, array $payload): array    {        $ch = curl_init($this->baseUrl . $endpoint);        curl_setopt_array($ch, [            CURLOPT_RETURNTRANSFER => true,            CURLOPT_POST => true,            CURLOPT_HTTPHEADER => [                'Authorization: Bearer ' . $this->apiKey,                'Content-Type: application/json',            ],            CURLOPT_POSTFIELDS => json_encode($payload),        ]);        $response = curl_exec($ch);        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);        curl_close($ch);        if ($httpCode >= 400) {            throw new \RuntimeException("Firecrawl API error: HTTP $httpCode");        }        return json_decode($response, true);    }    public function scrape(string $url, array $options = []): array    {        return $this->post('/scrape', array_merge(['url' => $url], $options));    }    public function search(string $query, int $limit = 5): array    {        return $this->post('/search', ['query' => $query, 'limit' => $limit]);    }}// Uso$app = new Firecrawl(getenv('FIRECRAWL_API_KEY'));$result = $app->scrape('https://example.com');echo $result['data']['markdown'];

Próximos pasos#

Documentación de búsqueda

Busca en la web y obtén el contenido completo de la página

Documentación de scraping

Todas las opciones de scraping, incluidos los formatos, las acciones y los proxies

Documentación de interacción

Haz clic, completa formularios y extrae contenido dinámico

Referencia de la API

Documentación completa de la API REST