natural-language-guided single-page data extraction
Extracts structured data from a single web page using semantic AI understanding rather than CSS selectors or XPath. The AiScraper client sends a URL and natural language prompt to the Oxylabs API, which uses vision and language models to understand page semantics, locate relevant content, and return structured JSON matching the requested schema. This approach is resilient to DOM changes because it operates on semantic meaning rather than brittle selectors.
Unique: Uses vision-language models to understand page semantics and extract data based on meaning rather than DOM structure, making it resilient to HTML changes that would break traditional CSS/XPath selectors. The SDK abstracts job polling and retry logic, exposing a simple scrape() method that handles async API communication internally.
vs alternatives: More resilient to website structure changes than Puppeteer/Selenium + regex, and requires no selector maintenance compared to BeautifulSoup or Scrapy, though with higher latency due to remote AI processing.
multi-page semantic crawling with natural language navigation
Discovers and extracts data from multiple related pages across a website using AI-driven navigation. The AiCrawler client accepts a starting URL and a natural language prompt describing which pages to visit (e.g., 'follow all product links and extract prices'), then uses semantic understanding to identify relevant links, navigate to them, and extract data from each page. The SDK manages job polling and pagination internally, returning aggregated results from all discovered pages.
Unique: Uses semantic understanding to identify which links to follow based on natural language intent, rather than requiring hardcoded URL patterns or CSS selectors. The SDK's job polling pattern abstracts the asynchronous crawl lifecycle, allowing developers to write synchronous code that internally manages long-running API operations.
vs alternatives: Eliminates the need for custom link-following logic compared to Scrapy or Selenium, and adapts to website structure changes automatically because navigation is semantic rather than pattern-based. Slower than headless browser crawlers but requires no JavaScript rendering overhead.
output format flexibility with multiple serialization options
Supports multiple output formats for extracted data, including JSON, HTML, CSV, and raw text. The SDK allows developers to specify desired output format per request, and handles serialization and formatting automatically. This capability enables integration with downstream tools and databases that expect specific formats without requiring post-processing.
Unique: Provides flexible output format options integrated into the extraction pipeline, allowing developers to specify format at request time without post-processing. The SDK handles serialization automatically based on format selection.
vs alternatives: More convenient than post-processing extraction results to convert formats, and supports multiple formats without additional dependencies. Limited to formats supported by the SDK.
error handling and resilience with detailed failure diagnostics
Provides comprehensive error handling with detailed diagnostics for extraction failures, including retry logic for transient errors, timeout handling, and structured error messages. The SDK distinguishes between transient errors (network timeouts, temporary API unavailability) and permanent errors (invalid input, authentication failure), applying appropriate retry strategies. Error responses include detailed context (which step failed, why, what was attempted) to aid debugging.
Unique: Integrates error handling and retry logic into the SDK's job polling pattern, automatically retrying transient failures with exponential backoff while providing detailed diagnostics for permanent failures. Distinguishes between error types to apply appropriate recovery strategies.
vs alternatives: More integrated than manual retry logic and provides better diagnostics than generic HTTP error handling. Automatic retry reduces boilerplate code compared to implementing custom retry decorators.
rate limiting and api quota management with usage tracking
Tracks API usage and enforces rate limits to prevent quota exhaustion. The SDK monitors the number of requests made and remaining quota, and can throttle requests to stay within rate limits. It provides usage statistics and quota warnings to help developers understand their consumption patterns and avoid unexpected quota overages.
Unique: Integrates rate limiting and quota tracking into the SDK's request pipeline, providing automatic throttling and usage statistics without requiring external monitoring tools. The SDK tracks quota consumption and warns developers when approaching limits.
vs alternatives: More integrated than manual quota tracking and provides automatic throttling without external rate limiting services. Depends on accurate quota information from the Oxylabs API.
browser automation with natural language action sequences
Automates complex browser interactions (clicking, form filling, navigation, waiting) using high-level natural language instructions instead of imperative code. The BrowserAgent client accepts a starting URL and an action prompt (e.g., 'log in with email, search for laptops, sort by price'), then uses AI to interpret the prompt, execute the sequence of browser actions, and return the final page state or extracted data. The SDK handles browser session management, JavaScript rendering, and action execution remotely.
Unique: Interprets natural language action sequences using AI models rather than requiring imperative Selenium/Playwright code, making it accessible to non-programmers. The SDK manages remote browser session lifecycle and JavaScript rendering, abstracting away the complexity of headless browser control.
vs alternatives: More intuitive than Selenium for non-technical users and requires no knowledge of DOM selectors or browser APIs. Slower than local Playwright due to remote execution, but eliminates the need to maintain browser automation code as websites change.
web search with semantic result filtering and content extraction
Performs web searches and retrieves content from search results using semantic filtering and AI-powered extraction. The AiSearch client accepts a search query and optional filters (e.g., 'find articles about AI safety published in the last month'), then returns a list of search results with extracted content from each page. The SDK handles search engine integration, result ranking, and per-result content extraction internally.
Unique: Combines web search with AI-powered content extraction from results, allowing developers to retrieve and structure data from search results in a single operation. The SDK abstracts search engine integration and per-result extraction, exposing a unified search() method.
vs alternatives: More integrated than using Google Search API + separate scraping tools, and provides structured extraction from results without additional parsing steps. Slower than direct search APIs but includes automatic content extraction.
website structure mapping and hierarchy discovery
Analyzes a website's structure to discover page hierarchies, relationships, and navigation patterns using semantic understanding. The AiMap client accepts a starting URL and returns a map of the site's structure, including discovered pages, their relationships, and navigation paths. This capability uses AI to understand site semantics (e.g., 'this is a product category page, these are product detail pages') rather than relying on URL patterns or sitemap files.
Unique: Uses semantic AI to classify page types and understand site structure based on content meaning rather than URL patterns or sitemap files, enabling discovery of sites without explicit navigation metadata. The SDK returns structured hierarchy data suitable for downstream crawling or analysis.
vs alternatives: More intelligent than URL pattern-based site mapping and does not require sitemap.xml files. Slower than parsing sitemaps but works on sites without explicit navigation metadata.
+5 more capabilities