PHP - Firecrawl Docs

Prérequis#

PHP 8.0+ avec l’extension cURL
Une clé API Firecrawl — obtenez-en une gratuitement

Rechercher sur le web#

Firecrawl fonctionne avec PHP via l’API REST à l’aide de 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";}

Exemple de réponse

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

Scraper une page#

<?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'];

Exemple de réponse

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

Interagir avec une page#

Démarrez une session de navigateur, interagissez avec la page à l’aide d’instructions en langage naturel, puis fermez la session.

Étape 1 — Scrapez pour démarrer une session#

<?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";

Étape 2 — Envoyer les interactions#

<?php$interactUrl = "https://api.firecrawl.dev/v2/scrape/$scrapeId/interact";$headers = [    'Authorization: Bearer ' . $apiKey,    'Content-Type: application/json',];// Rechercher un produit$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";// Cliquer sur le premier résultat$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";

Étape 3 — Mettre fin à la session#

<?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 "Session arrêtée\n";

Classe utilitaire réutilisable#

Pour un usage répété, encapsulez l’API dans une classe :

<?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]);    }}// Utilisation$app = new Firecrawl(getenv('FIRECRAWL_API_KEY'));$result = $app->scrape('https://example.com');echo $result['data']['markdown'];

Étapes suivantes#

Docs Search

Recherchez sur le Web et obtenez le contenu intégral de la page

Docs Scrape

Toutes les options de scrape, y compris les formats, les actions et les proxys

Docs Interact

Cliquez, remplissez des formulaires et extrayez du contenu dynamique

Référence de l’API

Documentation complète de l’API REST