PHP

# cURL is built into PHP — no composer package needed
# To use Guzzle instead:
composer require guzzlehttp/guzzle

<?php

$apiKey = getenv('SCHEMACHECK_API_KEY');
$url    = 'https://stripe.com';

function validateUrl(string $url, string $apiKey): array {
    $endpoint = 'https://schemacheck.dev/api/v1/validate?' . http_build_query([
        'url'        => $url,
        'access_key' => $apiKey,
    ]);

    $ch = curl_init($endpoint);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 30,
    ]);

    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $data = json_decode($body, true);

    if ($status >= 400 || !($data['success'] ?? false)) {
        $code    = $data['error']['code']    ?? 'unknown';
        $message = $data['error']['message'] ?? 'Unknown error';
        throw new RuntimeException("[{$code}] {$message}");
    }

    return $data;
}

$result = validateUrl($url, $apiKey);

printf("Score: %d/100\n", $result['summary']['score']);
printf("Schemas found: %d\n", $result['schemas_found']);

foreach ($result['schemas'] as $schema) {
    printf("\n[%s] valid=%s rich_result=%s\n",
        $schema['type'],
        $schema['valid'] ? 'true' : 'false',
        $schema['rich_result_eligible'] ? 'true' : 'false',
    );

    foreach ($schema['errors'] as $error) {
        printf("  ✗ %s: %s\n", $error['property'], $error['message']);
        printf("    Fix: %s\n", $error['fix']);
    }
}

<?php

function validateJsonLd(array $jsonld, string $apiKey): array {
    $ch = curl_init('https://schemacheck.dev/api/v1/validate');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode(['jsonld' => $jsonld]),
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'x-api-key: ' . $apiKey,
        ],
        CURLOPT_TIMEOUT        => 30,
    ]);

    $body   = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $data = json_decode($body, true);

    if ($status >= 400 || !($data['success'] ?? false)) {
        $code    = $data['error']['code']    ?? 'unknown';
        $message = $data['error']['message'] ?? 'Unknown error';
        throw new RuntimeException("[{$code}] {$message}");
    }

    return $data;
}

$result = validateJsonLd([
    '@context'      => 'https://schema.org',
    '@type'         => 'Article',
    'headline'      => 'How to validate Schema.org structured data',
    'author'        => ['@type' => 'Person', 'name' => 'Jane Doe'],
    'datePublished' => '2026-03-18',
    'image'         => 'https://example.com/photo.jpg',
], getenv('SCHEMACHECK_API_KEY'));

$schema = $result['schemas'][0];
if (!$schema['valid']) {
    foreach ($schema['errors'] as $e) {
        echo "Error: {$e['property']}: {$e['fix']}\n";
    }
    exit(1);
}

echo 'Valid! Rich result eligible: ' . ($schema['rich_result_eligible'] ? 'yes' : 'no') . "\n";

<?php

use GuzzleHttp\Client;
use GuzzleHttp\Exception\ClientException;

$client = new Client([
    'base_uri' => 'https://schemacheck.dev/api/v1/',
    'timeout'  => 30,
]);

$apiKey = getenv('SCHEMACHECK_API_KEY');

try {
    $response = $client->get('validate', [
        'query' => [
            'url'        => 'https://stripe.com',
            'access_key' => $apiKey,
        ],
    ]);

    $data = json_decode($response->getBody(), true);

    printf("Score: %d/100\n", $data['summary']['score']);
    printf("Cached: %s\n", $data['meta']['cached'] ? 'yes' : 'no');

} catch (ClientException $e) {
    $data = json_decode($e->getResponse()->getBody(), true);
    $code = $data['error']['code'] ?? 'unknown';
    echo "API error [{$code}]: {$data['error']['message']}\n";
}