Scrape Any Website with OpenAI Function Calling in PHP

Sep 25, 2023 ยท 7 min read

Web scraping allows extracting data from websites programmatically. This is useful for gathering information like prices, inventory, reviews etc.

OpenAI provides an innovative approach to build robust web scrapers using natural language processing.

In this post, we will walk through a complete PHP code example that leverages OpenAI function calling to scrape product data from a sample ecommerce website.

Leveraging OpenAI function calling

OpenAI function calling provides a way to define schemas for the data you want extracted from a given input. When making an API request, you can specify a function name and parameters representing the expected output format.

OpenAI's natural language model will then analyze the provided input, extract relevant data from it, and return the extracted information structured according to the defined schema.

This pattern separates the raw data extraction capabilities of the AI model from your downstream data processing logic. Your code simply expects the data in a clean, structured format based on the function specification.

By leveraging OpenAI's natural language processing strengths for data extraction, you can create web scrapers that are resilient to changes in the underlying page structure and content. The business logic remains high-level and focused on data usage, while OpenAI handles the messy details of parsing and extracting information from complex HTML.

Why use function calling

One key advantage of this web scraping technique is that the core scraper logic is immune to changes in the HTML structure of the target site. Since OpenAI is responsible for analyzing the raw HTML and extracting the desired data, the PHP code does not make any assumptions about HTML structure. The scraper will adapt as long as the sample HTML provided to OpenAI reflects the current page structure. This makes the scraper much more robust against site redesigns compared to scraping code that depends on specific HTML elements.

Overview

Here is an overview of the web scraping process we will implement:

  1. Send HTML representing the target page to OpenAI
  2. OpenAI analyzes the HTML and extracts the data we want
  3. OpenAI returns the extracted data structured as defined in our PHP function
  4. Process the extracted data in PHP as needed

This allows creating a scraper that adapts to changes in page layouts. The core logic stays high-level while OpenAI handles analyzing the raw HTML.

Sample HTML

First, we need some sample HTML representing the page content we want to scrape.

Here is sample HTML for a page listing 3 products:

<div class="products">

  <div class="product">
    <h3>Blue T-Shirt</h3>
    <p>A comfortable blue t-shirt made from 100% cotton.</p>
    <p>Price: $14.99</p>
  </div>

  <div class="product">
    <h3>Noise Cancelling Headphones</h3>
    <p>These wireless over-ear headphones provide active noise cancellation.</p>
    <p>Price: $199.99</p>
  </div>

  <div class="product">
    <h3>Leather Laptop Bag</h3>
    <p>Room enough for up to a 15" laptop. Made from genuine leather.</p>
    <p>Price: $49.99</p>
  </div>

</div>

This contains 3 product listings, each with a title, description and price.

Sending HTML to OpenAI

Next, we need to send this sample HTML to the OpenAI API. The HTML is passed in the content parameter:

$messages = [
  [
    'role' => 'user',
    'content' => $html
  ]
];

This will allow OpenAI to analyze the HTML structure.

Defining Output Schema

We need to define the expected output schema so OpenAI knows what data to extract.

We'll define a extracted_data function with a products array parameter:

$functions = [
  [
    'name' => 'extracted_data',

    'parameters' => [
      'type' => 'array',

      'items' => [
        'type' => 'object',

        'properties' => [
          'title' => [
             'type' => 'string'
          ],
          'description' => [
             'type' => 'string'
          ],
          'price' => [
             'type' => 'string'
          ]
        ]
      ]
    ]

  ]
];

This specifies we want an array of product objects, each with a title, description and price.

Calling OpenAI API

Now we can call the OpenAI API, passing the HTML and function definition:

$data = [
  'model' => 'text-davinci-003',
  'messages' => $messages,
  'functions' => $functions
];

$response = openai_call($data);

This will analyze the HTML and return extracted data matching the schema we defined.

Processing Extracted Data

Finally, we can process the extracted data in our PHP function:

function extracted_data($products) {

  // Output product data
  foreach ($products as $product) {

    echo "<h2>" . $product['title'] . "</h2>";

    echo "<p>" . $product['description'] . "</p>";

    echo "<p>Price: " . $product['price'] . "</p>";

  }

}

This simply loops through and prints each product's details. We could also save the data to a database etc.

Full Code Example

Here is the complete PHP code to scrape product data using OpenAI function calling:

<?php

// Extracted data function 
function extracted_data($products) {

  echo "<h1>Extracted Product Data</h1>";

  foreach ($products as $product) {

    echo "<h2>" . $product['title'] . "</h2>";
    
    echo "<p>" . $product['description'] . "</p>";

    echo "<p>Price: " . $product['price'] . "</p>";

    echo "<hr>";

  }

  $ret = [
    'status' => 'saved'
  ];
  
  return json_encode($ret);

}

// Sample HTML
$html = '

  <div class="products">
  
    <div class="product">
      <h3>Blue T-Shirt</h3>
      <p>A comfortable blue t-shirt made from 100% cotton.</p>
      <p>Price: $14.99</p>
    </div>

    <div class="product">
      <h3>Noise Cancelling Headphones</h3>
      <p>These wireless over-ear headphones provide active noise cancellation.</p>
      <p>Price: $199.99</p>
    </div>

    <div class="product">
      <h3>Leather Laptop Bag</h3>
      <p>Room enough for up to a 15" laptop. Made from genuine leather.</p>
      <p>Price: $49.99</p>
    </div>

  </div>
  
';

// Send HTML to OpenAI
$messages = [
  
  ['role' => 'user', 'content' => $html]
  
];

// Function schema
$functions = [

  [
    'name' => 'extracted_data',
    'description' => 'push the extracted product data from html for storage',  
    'parameters' => [
      'type' => 'object',
      'properties' => [
        'products' => [
          'type' => 'object',
          'properties' => [
            'title' => [
              'type' => 'string',
              'description' => 'title of the product'
            ],
            'description' => [
             'type' => 'string',
             'description' => 'description of the product'
            ],
            'price' => [
              'type' => 'string',
              'description' => 'price of the product'
            ]
          ]
        ]
      ],
      'required' => ['products']
    ]
  ]

];

$data = [
  'model' => 'text-davinci-003', 
  'messages' => $messages,
  'functions' => $functions
];

// Helper function
function openai_call($data) {

  $apiKey = 'sk-xxx'; 

  $url = 'https://api.openai.com/v1/chat/completions';
  
  $payload = json_encode($data);

  $headers = [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
  ];
  
  $ch = curl_init($url);

  curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
  
  curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
  
  curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  
  $response = curl_exec($ch);

  return json_decode($response, true);

}

// Call API
$response = openai_call($data);

?>

Conclusion

Using OpenAI opens up an exciting new way to approach web scraping whih wasnt possible before

However, this approach also has some limitations:

  • The scraped code needs to handle CAPTCHAs, IP blocks and other anti-scraping measures
  • Running the scrapers on your own infrastructure can lead to IP blocks
  • Dynamic content needs specialized handling
  • A more robust solution is using a dedicated web scraping API like Proxies API

    With Proxies API, you get:

  • Millions of proxy IPs for rotation to avoid blocks
  • Automatic handling of CAPTCHAs, IP blocks
  • Rendering of Javascript-heavy sites
  • Simple API access without needing to run scrapers yourself
  • With features like automatic IP rotation, user-agent rotation and CAPTCHA solving, Proxies API makes robust web scraping easy via a simple API:

    curl "https://api.proxiesapi.com/?key=API_KEY&url=targetsite.com"
    

    Get started now with 1000 free API calls to supercharge your web scraping!

    Browse by tags:

    Browse by language:

    The easiest way to do Web Scraping

    Get HTML from any page with a simple API call. We handle proxy rotation, browser identities, automatic retries, CAPTCHAs, JavaScript rendering, etc automatically for you


    Try ProxiesAPI for free

    curl "http://api.proxiesapi.com/?key=API_KEY&url=https://example.com"

    <!doctype html>
    <html>
    <head>
        <title>Example Domain</title>
        <meta charset="utf-8" />
        <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1" />
    ...

    X

    Don't leave just yet!

    Enter your email below to claim your free API key: