PHP code example of novada / sdk

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

novada / sdk example snippets

declare(strict_types=1);

roxy\Dto\ListWhitelistParams;
use Novada\Proxy\Product;

$client = new Client('YOUR_API_KEY'); // or null to read NOVADA_API_KEY

$list = $client->proxy->whitelist->list(new ListWhitelistParams(
    product: Product::Residential,
));

printf("whitelist total=%d\n", $list->total);

use Novada\Client;
use Novada\ClientConfig;

$client = new Client('API_KEY', new ClientConfig(
    baseUrl: 'https://api-m.novada.com',
    webUnblockerUrl: 'https://webunlocker.novada.com',
    scraperUrl: 'https://scraper.novada.com',
    timeout: 30.0,
    maxRetries: 2,
    httpClient: $psr18Client,       // optional: inject your own PSR-18 client
    requestFactory: $psr17Factory,  // optional: inject your own PSR-17 request factory
    streamFactory: $psr17Factory,   // optional: inject your own PSR-17 stream factory
    userAgent: 'my-app/1.0',
));

use Novada\Proxy\Dto\{AddWhitelistParams, CreateAccountParams, ListAccountParams, ListWhitelistParams,
    OpenStaticIspParams, TimeRange};
use Novada\Proxy\Product;

// Sub-accounts
$client->proxy->account->create(new CreateAccountParams(
    product: Product::Residential, account: 'account11', password: 'pass11', status: 1,
));
$client->proxy->account->list(new ListAccountParams(product: Product::Residential));

// Whitelist
$client->proxy->whitelist->add(new AddWhitelistParams(
    product: Product::Residential, ip: '10.10.10.1', remark: 'test',
));
$client->proxy->whitelist->list(new ListWhitelistParams(product: Product::Residential));

// Residential areas & traffic
$client->proxy->residential->countries();
$client->proxy->residential->balance();
$client->proxy->residential->consumeLog(new TimeRange(
    start: '2025-01-01 00:00:00', end: '2025-01-31 23:59:59',
));

// Static ISP / dedicated datacenter
$client->proxy->staticIsp->open(new OpenStaticIspParams(
    ipType: 'normal', region: 'hk:1|us-va:2', duration: 'week', num: 3,
));
$client->proxy->dedicatedDc->list(new \Novada\Proxy\Dto\ListStaticParams());

use Novada\Scraper\Dto\{GoogleSearchParams, Request as ScrapeRequest, UnblockerParams, YouTubeVideoParams};
use Novada\Scraper\Target;

// Strongly typed (auto-selects the Scraper API host)
$res = $client->scraper->api->youtube->videoPost(new YouTubeVideoParams(
    url: 'https://www.youtube.com/watch?v=HAwTwmzgNc4',
));

// Google Search (SerpApi) — typed params, structured result ($result->data->json is the raw result array)
$gs = $client->scraper->api->google->search(new GoogleSearchParams(
    query: 'apple', country: 'us', // device, hl, renderJs, aiOverview, … optional
));
printf("%d %d\n", $gs->code, $gs->costTime);

// Generic driver — any scraper_id, choose the host explicitly
$res = $client->scraper->do(new ScrapeRequest(
    target: Target::ScraperApi, // or Target::WebUnblocker
    scraperName: 'youtube.com',
    scraperId: 'youtube_video-post_explore',
    params: [['url' => 'https://www.youtube.com/watch?v=HAwTwmzgNc4']],
    returnErrors: true,
));
echo $res->raw; // raw scrape result (JSON/CSV/XLSX, depending on scraper)

// Web Unblocker — typed scrape; returns a structured result, not raw text
$unb = $client->scraper->unblocker->scrape(new UnblockerParams(
    targetUrl: 'https://www.google.com', // 

use Novada\Wallet\Dto\UsageRecordParams;

$client->wallet->balance();
$client->wallet->usageRecord(new UsageRecordParams(page: 1, limit: 20));

use Novada\Exception\ApiException;
use Novada\Exception\AuthException;
use Novada\Exception\RateLimitException;
use Novada\Proxy\Dto\ListWhitelistParams;
use Novada\Proxy\Product;

try {
    $list = $client->proxy->whitelist->list(new ListWhitelistParams(product: Product::Residential));
} catch (AuthException $e) {           // HTTP 401/403
    error_log('invalid API key');
} catch (RateLimitException $e) {      // HTTP 429
    error_log('rate limited');
} catch (ApiException $e) {            // any other API error, business code in getCode()
    error_log(sprintf('business error code=%d: %s', $e->getCode(), $e->getMsg()));
}