PyPI Pakket: olostep | Vereisten: Python 3.11+

Installatie

pip install olostep

pip3 install olostep

poetry add olostep

uv pip install olostep

Authenticatie

Haal je API-sleutel op van het Olostep Dashboard.

Snelle Start

De SDK biedt twee clientopties, afhankelijk van je gebruikssituatie:

Sync Client (`Olostep`)

Beste voor: Scripts en eenvoudige gebruikssituaties waar je voorkeur hebt voor blokkerende operaties.

De sync client biedt een eenvoudigere, blokkerende interface die gemakkelijker te gebruiken is als je nieuw bent met async/await.

Async Client (`AsyncOlostep`)

Beste voor: Productietoepassingen en het afhandelen van veel gelijktijdige verzoeken.

De async client biedt niet-blokkerende operaties en is de aanbevolen keuze voor productietoepassingen die hoge doorvoer nodig hebben.

Sync Client (Olostep)

De sync client (Olostep) biedt een blokkerende interface die perfect is voor scripts en eenvoudige gebruikssituaties.

from olostep import Olostep

# Geef de API-sleutel op door de 'api_key' parameter door te geven of
# door de OLOSTEP_API_KEY omgevingsvariabele in te stellen

# De sync client beheert automatisch resourcebeheer
# Geen expliciete sluiting nodig - resources worden opgeruimd na elke operatie
client = Olostep(api_key="YOUR_REAL_KEY")
scrape_result = client.scrapes.create(url_to_scrape="https://example.com")

Basis Web Scraping

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Eenvoudig scrapen
result = client.scrapes.create(url_to_scrape="https://example.com")
print(f"Scraped {len(result.html_content)} characters")

# Meerdere formaten
result = client.scrapes.create(
    url_to_scrape="https://example.com",
    formats=["html", "markdown"]
)
print(f"HTML: {len(result.html_content)} chars")
print(f"Markdown: {len(result.markdown_content)} chars")

Batchverwerking

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Verwerk meerdere URL's efficiënt
batch = client.batches.create(
    urls=[
        "https://www.google.com/search?q=python",
        "https://www.google.com/search?q=javascript",
        "https://www.google.com/search?q=typescript"
    ]
)

# Wacht op voltooiing en verwerk resultaten
for item in batch.items():
    content = item.retrieve(["html"])
    print(f"Processed {item.url}: {len(content.html_content)} bytes")

Slim Web Crawlen

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Crawlen met intelligente filtering
crawl = client.crawls.create(
    start_url="https://www.bbc.com",
    max_pages=100,
    include_urls=["/articles/**", "/blog/**"],
    exclude_urls=["/admin/**"]
)

for page in crawl.pages():
    content = page.retrieve(["html"])
    print(f"Crawled: {page.url}")

Site Mapping

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Alle links van een website extraheren
maps = client.maps.create(url="https://example.com")

# Alle ontdekte URL's ophalen
urls = []
for url in maps.urls():
    urls.append(url)
    if len(urls) >= 10:  # Limiet voor demo
        break

print(f"Found {len(urls)} URLs")

AI-aangedreven Antwoorden

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Antwoorden van webpagina's verkrijgen met AI
answer = client.answers.create(
    task="What is the main topic of https://example.com?"
)
print(f"Answer: {answer.answer}")

Async Client (AsyncOlostep)

De async client (AsyncOlostep) is de aanbevolen client voor toepassingen met hoge prestaties, backendservices, en wanneer je veel gelijktijdige verzoeken moet afhandelen.

from olostep import AsyncOlostep

# Geef de API-sleutel op door de 'api_key' parameter door te geven of
# door de OLOSTEP_API_KEY omgevingsvariabele in te stellen

# RESOURCEBEHEER
# ==============
# De SDK ondersteunt twee gebruikspatronen voor resourcebeheer:

# 1. Context Manager (Aanbevolen voor eenmalig gebruik):
#    Behandelt automatisch het opruimen van resources
async with AsyncOlostep(api_key="YOUR_REAL_KEY") as client:
    scrape_result = await client.scrapes.create(url_to_scrape="https://example.com")
# Transport wordt hier automatisch gesloten

# 2. Expliciete Sluiting (Voor langlopende services):
#    Vereist handmatige opruiming van resources
client = AsyncOlostep(api_key="YOUR_REAL_KEY")
try:
    scrape_result = await client.scrapes.create(url_to_scrape="https://example.com")
finally:
    await client.close()  # Handmatig het transport sluiten

Basis Web Scraping

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # Eenvoudig scrapen
        result = await client.scrapes.create(url_to_scrape="https://example.com")
        print(f"Scraped {len(result.html_content)} characters")

        # Meerdere formaten
        result = await client.scrapes.create(
            url_to_scrape="https://example.com",
            formats=["html", "markdown"]
        )
        print(f"HTML: {len(result.html_content)} chars")
        print(f"Markdown: {len(result.markdown_content)} chars")

asyncio.run(main())

Batchverwerking

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # Verwerk meerdere URL's efficiënt
        batch = await client.batches.create(
            urls=[
                "https://www.google.com/search?q=python",
                "https://www.google.com/search?q=javascript",
                "https://www.google.com/search?q=typescript"
            ]
        )

        # Wacht op voltooiing en verwerk resultaten
        async for item in batch.items():
            content = await item.retrieve(["html"])
            print(f"Processed {item.url}: {len(content.html_content)} bytes")

asyncio.run(main())

Slim Web Crawlen

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # Crawlen met intelligente filtering
        crawl = await client.crawls.create(
            start_url="https://www.bbc.com",
            max_pages=100,
            include_urls=["/articles/**", "/blog/**"],
            exclude_urls=["/admin/**"]
        )

        async for page in crawl.pages():
            content = await page.retrieve(["html"])
            print(f"Crawled: {page.url}")

asyncio.run(main())

Site Mapping

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # Alle links van een website extraheren
        maps = await client.maps.create(url="https://example.com")

        # Alle ontdekte URL's ophalen
        urls = []
        async for url in maps.urls():
            urls.append(url)
            if len(urls) >= 10:  # Limiet voor demo
                break

        print(f"Found {len(urls)} URLs")

asyncio.run(main())

AI-aangedreven Antwoorden

import asyncio
from olostep import AsyncOlostep

async def main():
    async with AsyncOlostep(api_key="your-api-key") as client:
        # Antwoorden van webpagina's verkrijgen met AI
        answer = await client.answers.create(
            task="What is the main topic of https://example.com?"
        )
        print(f"Answer: {answer.answer}")

asyncio.run(main())

SDK Referentie

Methode Structuur

Beide SDK-clients bieden dezelfde schone, pythonische interface georganiseerd in logische namespaces:

Namespace	Doel	Belangrijkste Methoden
`scrapes`	Enkelvoudige URL-extractie	`create()`, `get()`
`batches`	Multi-URL verwerking	`create()`, `info()`, `items()`
`crawls`	Website doorzoeken	`create()`, `info()`, `pages()`
`maps`	Linkextractie	`create()`, `urls()`
`answers`	AI-aangedreven extractie	`create()`, `get()`
`retrieve`	Inhoud ophalen	`get()`

Elke operatie retourneert stateful objecten met ergonomische methoden voor vervolgoperaties.

Foutafhandeling

Vang alle SDK-fouten op met de basis-exceptieklasse:

from olostep import Olostep, Olostep_BaseError

client = Olostep(api_key="your-api-key")

try:
    result = client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_BaseError as e:
    print(f"Error has occurred: {type(e).__name__}")
    print(f"Error message: {e}")

Voor gedetailleerde foutafhandelingsinformatie, inclusief de volledige exceptiehiërarchie en gedetailleerde foutafhandelingsopties, zie Gedetailleerde Foutafhandeling.

Automatische Herhalingen

De SDK probeert automatisch opnieuw bij tijdelijke fouten (netwerkproblemen, tijdelijke serverproblemen) op basis van de RetryStrategy configuratie. Je kunt het herhalingsgedrag aanpassen door een RetryStrategy instantie door te geven bij het maken van de client:

from olostep import Olostep, RetryStrategy

retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)

client = Olostep(api_key="your-api-key", retry_strategy=retry_strategy)
result = client.scrapes.create("https://example.com")

Voor gedetailleerde herhalingsconfiguratie-opties en best practices, zie Retry Strategie.

Geavanceerde Functies

Slimme Input Coercion

De SDK behandelt intelligent verschillende invoerformaten voor maximale gemak:

from olostep import Olostep, Country

client = Olostep(api_key="your-api-key")

# Formaten: string, lijst of enum
client.scrapes.create(url_to_scrape="https://example.com", formats="html")
client.scrapes.create(url_to_scrape="https://example.com", formats=["html", "markdown"])

# Landen: hoofdletterongevoelige strings of enums
client.scrapes.create(url_to_scrape="https://example.com", country="us")
client.scrapes.create(url_to_scrape="https://example.com", country=Country.US)

# Lijsten: enkele waarden of lijsten
client.batches.create(urls="https://example.com")    # Enkele URL
client.batches.create(urls=["https://a.com", "https://b.com"])  # Meerdere URL's

Geavanceerde Scraping Opties

from olostep import Olostep, Format, Country, WaitAction, FillInputAction

client = Olostep(api_key="your-api-key")

# Volledige controle over scraping gedrag
result = client.scrapes.create(
    url_to_scrape="https://news.google.com/",
    wait_before_scraping=3000,
    formats=[Format.HTML, Format.MARKDOWN],
    remove_css_selectors=["script", ".popup"],
    actions=[
        WaitAction(milliseconds=1500),
        FillInputAction(selector="searchbox", value="olostep")
    ],
    parser="@olostep/google-news",
    country=Country.US,
    remove_images=True
)

Caching

Standaard haalt elk scrape-verzoek de pagina vers op (max_age=0). Geef max_age door om een recent resultaat met dezelfde parameters opnieuw te gebruiken en de responstijd te verbeteren. De waarde is in seconden; de maximum is 7 dagen (604800). Zie Caching voor details.

# Opt-in voor caching: accepteer resultaten tot 1 dag (86400 seconden) oud
result = client.scrapes.create(
    url_to_scrape="https://example.com",
    formats=["markdown"],
    max_age=86400
)

Opslag

Standaard wordt een scrape-resultaat ongeveer 7 dagen bewaard. Geef storage door met expires_in ingesteld op 10d, 30d, 60d, 90d, 180d, 365d, of never om het langer te bewaren. Zie Opslag voor details.

result = client.scrapes.create(
    url_to_scrape="https://example.com",
    formats=["markdown"],
    storage={"expires_in": "90d"}
)

Batchverwerking met Aangepaste ID’s

from olostep import Olostep, Country

client = Olostep(api_key="your-api-key")

batch = client.batches.create([
    {"url": "https://www.google.com/search?q=python", "custom_id": "search_1"},
    {"url": "https://www.google.com/search?q=javascript", "custom_id": "search_2"},
    {"url": "https://www.google.com/search?q=typescript", "custom_id": "search_3"}
],
country=Country.US,
parser="@olostep/google-search"
)

# Verwerk resultaten op aangepaste ID
# Bij gebruik van een parser, haal JSON-inhoud op in plaats van HTML
for item in batch.items():
    if item.custom_id == "search_2":
        content = item.retrieve(["json"])
        print(f"Search result: {content.json_content}")

Intelligente Crawling

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Crawlen met intelligente filtering
crawl = client.crawls.create(
    start_url="https://www.bbc.com",
    max_pages=1000,
    max_depth=3,
    include_urls=["/articles/**", "/news/**"],
    exclude_urls=["/ads/**", "/tracking/**"],
    include_external=False,
    include_subdomain=True,
)

for page in crawl.pages():
    content = page.retrieve(["html"])
    print(f"Crawled: {page.url}")

Site Mapping met Filters

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Alle links extraheren met geavanceerde filtering
maps = client.maps.create(
    url="https://www.bbc.com",
    include_subdomain=True,
    include_urls=["/articles/**", "/news/**"],
    exclude_urls=["/ads/**", "/tracking/**"]
)

# Gefilterde URL's ophalen
urls = []
for url in maps.urls():
    urls.append(url)

print(f"Found {len(urls)} relevant URLs")

Antwoorden Ophalen

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Eerst een antwoord maken
created_answer = client.answers.create(
    task="What is the main topic of https://example.com?"
)

# Vervolgens ophalen met behulp van de ID
answer = client.answers.get(answer_id=created_answer.id)
print(f"Answer: {answer.answer}")

Inhoud Ophalen

from olostep import Olostep

client = Olostep(api_key="your-api-key")

# Inhoud ophalen met retrieve ID
result = client.retrieve.get(retrieve_id="ret_123")

# Meerdere formaten ophalen
result = client.retrieve.get(retrieve_id="ret_123", formats=["html", "markdown", "text", "json"])

Logging

Schakel logging in om problemen op te sporen:

import logging

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger("olostep")
logger.setLevel(logging.INFO)  # Gebruik DEBUG voor gedetailleerde output

Logniveaus: INFO (aanbevolen), DEBUG (gedetailleerd), WARNING, ERROR

Retry Strategie Configuratie

De RetryStrategy klasse regelt hoe de Olostep SDK omgaat met tijdelijke API-fouten door middel van automatische herhalingen met exponentiële backoff en jitter. Dit helpt om betrouwbare werking te garanderen in productieomgevingen waar tijdelijke netwerkproblemen, snelheidslimieten en serveroverbelasting intermitterende fouten kunnen veroorzaken.

Standaard Gedrag

Standaard gebruikt de SDK de volgende retry-configuratie:

Max retries: 5 pogingen
Initiële vertraging: 2 seconden
Backoff: Exponentieel (2^poging)
Jitter: 10-90% van vertraging (gerandomiseerd)

Dit betekent:

Poging 1: Onmiddellijk
Poging 2: ~2-3.6s vertraging
Poging 3: ~4-7.2s vertraging
Poging 4: ~8-14.4s vertraging
Poging 5: ~16-28.8s vertraging

Maximale duur: ~57 seconden voor alle herhalingen (slechtste geval)

Aangepaste Configuratie

from olostep import AsyncOlostep, RetryStrategy

# Maak aangepaste retry-strategie
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,  # 20% minimale jitter
    jitter_max=0.8,  # 80% maximale jitter
)

# Gebruik met client
async with AsyncOlostep(
    api_key="your-api-key",
    retry_strategy=retry_strategy
) as client:
    result = await client.scrapes.create("https://example.com")

Wanneer Herhalingen Plaatsvinden

De SDK probeert automatisch opnieuw bij:

Tijdelijke serverproblemen (OlostepServerError_TemporaryIssue)
Timeout reacties (OlostepServerError_NoResultInResponse)

Andere fouten (authenticatie, validatie, resource niet gevonden, etc.) falen onmiddellijk zonder herhaling.

Transport vs Caller Herhalingen

De SDK heeft twee herhalingslagen:

Transportlaag: Behandelt netwerklaag-verbindingfouten (DNS, timeouts, etc.)
Callerlaag: Behandelt API-laag tijdelijke fouten (gecontroleerd door RetryStrategy)

Beide lagen zijn onafhankelijk en hebben aparte configuratie. De totale maximale duur is de som van beide lagen.

Berekening van Maximale Duur

retry_strategy = RetryStrategy(max_retries=5, initial_delay=2.0)
max_duration = retry_strategy.max_duration()
print(f"Max call duration: {max_duration:.2f}s")

Configuratievoorbeelden

Hier zijn enkele voorbeelden van hoe je de retry-strategie kunt configureren voor verschillende gebruikssituaties.

Conservatieve Strategie

# Minder herhalingen, kortere vertragingen
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)
# Max duur: ~12.6s

Agressieve Strategie

# Meer herhalingen voor kritieke operaties
retry_strategy = RetryStrategy(
    max_retries=10,
    initial_delay=0.5
)
# Max duur: ~969.75s

Geen Herhalingen (Snel Falen)

# Herhalingen uitschakelen voor directe foutfeedback
retry_strategy = RetryStrategy(max_retries=0)

client = AsyncOlostep(api_key="your-api-key", retry_strategy=retry_strategy)

Hoge-Throughput Strategie

# Geoptimaliseerd voor operaties met hoog volume
retry_strategy = RetryStrategy(
    max_retries=2,
    initial_delay=0.5,
    jitter_min=0.1,
    jitter_max=0.3  # Lagere jitter voor meer voorspelbare timing
)
# Max duur: ~1.95s

Begrijpen van Jitter

Jitter voegt randomisatie toe om “thundering herd” problemen te voorkomen wanneer veel clients tegelijk opnieuw proberen. De jitter wordt als volgt berekend:

base_delay = initial_delay * (2 ** attempt)
jitter_range = base_delay * (jitter_max - jitter_min)
jitter = random.uniform(base_delay * jitter_min, base_delay * jitter_min + jitter_range)
final_delay = base_delay + jitter

Bijvoorbeeld, met initial_delay=2.0, jitter_min=0.1, jitter_max=0.9:

Poging 0: basis=2.0s, jitter=0.2-1.8s, eind=2.2-3.8s
Poging 1: basis=4.0s, jitter=0.4-3.6s, eind=4.4-7.6s
Poging 2: basis=8.0s, jitter=0.8-7.2s, eind=8.8-15.2s

Best Practices

Voor Productietoepassingen

# Gebalanceerde aanpak voor productie
retry_strategy = RetryStrategy(
    max_retries=5,
    initial_delay=2.0,
    jitter_min=0.1,
    jitter_max=0.9
)

Voor Ontwikkeling/Testen

# Snelle feedback voor ontwikkeling
retry_strategy = RetryStrategy(
    max_retries=2,
    initial_delay=0.5,
    jitter_min=0.1,
    jitter_max=0.3
)

Voor Batch Operaties

# Conservatief voor grote batchtaken
retry_strategy = RetryStrategy(
    max_retries=3,
    initial_delay=1.0,
    jitter_min=0.2,
    jitter_max=0.8
)

Monitoring en Debugging

De SDK logt retry-informatie op het DEBUG-niveau:

DEBUG: Tijdelijk probleem, opnieuw proberen in 2.34s
DEBUG: Geen resultaat in reactie, opnieuw proberen in 4.67s

Schakel debug logging in om het herhalingsgedrag te monitoren:

import logging
logging.getLogger("olostep").setLevel(logging.DEBUG)

Foutafhandeling

Wanneer alle herhalingen zijn uitgeput, wordt de oorspronkelijke fout opgeworpen:

try:
    result = await client.scrapes.create("https://example.com")
except OlostepServerError_TemporaryIssue as e:
    print(f"Failed after all retries: {e}")
    # Behandel de permanente fout

Prestatieoverwegingen

Geheugen: Elke herhalingspoging gebruikt extra geheugen voor verzoek/antwoord-objecten
Tijd: Totale operatietijd kan aanzienlijk langer zijn met herhalingen ingeschakeld
API-limieten: Herhalingen tellen mee voor je API-gebruiksbeperkingen
Netwerk: Meer netwerkverkeer door herhalingspogingen

Kies je retry-strategie op basis van de vereisten van je toepassing voor betrouwbaarheid versus prestaties.

Gedetailleerde Foutafhandeling

Exceptiehiërarchie

De Olostep SDK biedt een uitgebreide exceptiehiërarchie voor verschillende faalscenario’s. Alle excepties erven van Olostep_BaseError. Er zijn drie hoofdtypen fouten die direct erven van Olostep_BaseError:

Olostep_APIConnectionError - Netwerklaag-verbindingfouten
OlostepServerError_BaseError - Fouten veroorzaakt (soort van) door de API-server
OlostepClientError_BaseError - Fouten veroorzaakt door de client SDK

Waarom Verbindingfouten Apart Zijn

Olostep_APIConnectionError is apart van serverfouten omdat het netwerklaag-fouten vertegenwoordigt die optreden voordat de API het verzoek kan verwerken. Dit zijn transportlaagproblemen (DNS of HTTP-fouten, timeouts, verbinding geweigerd, etc.) in plaats van API-laagfouten. HTTP-statuscodes (4xx, 5xx) worden beschouwd als API-reacties en worden gecategoriseerd als serverfouten, ook al geven ze problemen aan.

Olostep_BaseError
├── Olostep_APIConnectionError
├── OlostepServerError_BaseError
│   ├── OlostepServerError_TemporaryIssue
│   │   ├── OlostepServerError_NetworkBusy
│   │   └── OlostepServerError_InternalNetworkIssue
│   ├── OlostepServerError_RequestUnprocessable
│   │   ├── OlostepServerError_ParserNotFound
│   │   └── OlostepServerError_OutOfResources
│   ├── OlostepServerError_BlacklistedDomain
│   ├── OlostepServerError_FeatureApprovalRequired
│   ├── OlostepServerError_AuthFailed
│   ├── OlostepServerError_CreditsExhausted
│   ├── OlostepServerError_InvalidEndpointCalled
│   ├── OlostepServerError_ResourceNotFound
│   ├── OlostepServerError_NoResultInResponse
│   └── OlostepServerError_UnknownIssue
└── OlostepClientError_BaseError
    ├── OlostepClientError_RequestValidationFailed
    ├── OlostepClientError_ResponseValidationFailed
    ├── OlostepClientError_NoAPIKey
    ├── OlostepClientError_AsyncContext
    ├── OlostepClientError_BetaFeatureAccessRequired
    └── OlostepClientError_Timeout

Aanbevolen Foutafhandeling

Voor de meeste gebruikssituaties, vang de basisfout op en print de foutnaam:

from olostep import AsyncOlostep, Olostep_BaseError

try:
    result = await client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_BaseError as e:
    print(f"Error has occurred: {type(e).__name__}")
    print(f"Error message: {e}")

Deze aanpak vangt alle SDK-fouten op en geeft duidelijke informatie over wat er misging. De foutnaam (bijv. OlostepServerError_AuthFailed) is beschrijvend genoeg om het probleem te begrijpen.

Gedetailleerde Foutafhandeling

Als je meer specifieke foutafhandeling nodig hebt, vang dan de specifieke fouttypen direct op. Vermijd het gebruik van OlostepServerError_BaseError of OlostepClientError_BaseError - deze basisklassen geven alleen aan wie de fout heeft veroorzaakt (server vs client), niet wie verantwoordelijk is voor het oplossen ervan. Dit is een implementatiedetail die niet helpt bij foutafhandelingslogica. In plaats daarvan, vang specifieke fouttypen op die het daadwerkelijke probleem aangeven:

from olostep import (
    AsyncOlostep,
    Olostep_BaseError,
    Olostep_APIConnectionError,
    OlostepServerError_AuthFailed,
    OlostepServerError_CreditsExhausted,
    OlostepClientError_NoAPIKey,
)

try:
    result = await client.scrapes.create(url_to_scrape="https://example.com")
except Olostep_APIConnectionError as e:
    print(f"Network error: {type(e).__name__}")
except OlostepServerError_AuthFailed:
    print("Invalid API key")
except OlostepServerError_CreditsExhausted:
    print("Credits exhausted")
except OlostepClientError_NoAPIKey:
    print("API key not provided")
except Olostep_BaseError as e:
    print(f"Error has occurred: {type(e).__name__}")

Configuratie

Omgevingsvariabelen

Variabele	Beschrijving	Standaard
`OLOSTEP_API_KEY`	Je API-sleutel	Vereist
`OLOSTEP_BASE_API_URL`	API basis-URL	`https://api.olostep.com/v1`
`OLOSTEP_API_TIMEOUT`	Verzoek timeout (seconden)	`150`

​Installatie

​Authenticatie

​Snelle Start

Sync Client (Olostep)

Async Client (AsyncOlostep)

​Sync Client (Olostep)

​Basis Web Scraping

​Batchverwerking

​Slim Web Crawlen

​Site Mapping

​AI-aangedreven Antwoorden

​Async Client (AsyncOlostep)

​Basis Web Scraping

​Batchverwerking

​Slim Web Crawlen

​Site Mapping

​AI-aangedreven Antwoorden

​SDK Referentie

​Methode Structuur

​Foutafhandeling

​Automatische Herhalingen

​Geavanceerde Functies

​Slimme Input Coercion

​Geavanceerde Scraping Opties

​Caching

​Opslag

​Batchverwerking met Aangepaste ID’s

​Intelligente Crawling

​Site Mapping met Filters

​Antwoorden Ophalen

​Inhoud Ophalen

​Logging

​Retry Strategie Configuratie

​Standaard Gedrag

​Aangepaste Configuratie

​Wanneer Herhalingen Plaatsvinden

​Transport vs Caller Herhalingen

​Berekening van Maximale Duur

​Configuratievoorbeelden

​Conservatieve Strategie

​Agressieve Strategie

​Geen Herhalingen (Snel Falen)

​Hoge-Throughput Strategie

​Begrijpen van Jitter

​Best Practices

​Voor Productietoepassingen

​Voor Ontwikkeling/Testen

​Voor Batch Operaties

​Monitoring en Debugging

​Foutafhandeling

​Prestatieoverwegingen

​Gedetailleerde Foutafhandeling

​Exceptiehiërarchie

​Waarom Verbindingfouten Apart Zijn

​Aanbevolen Foutafhandeling

​Gedetailleerde Foutafhandeling

​Configuratie

​Omgevingsvariabelen

​Hulp Krijgen

​Bronnen

PyPI Pakket

Verkrijg API-sleutel

Installatie

Authenticatie

Snelle Start

Sync Client (`Olostep`)

Async Client (`AsyncOlostep`)

Sync Client (Olostep)

Basis Web Scraping

Batchverwerking

Slim Web Crawlen

Site Mapping

AI-aangedreven Antwoorden

Async Client (AsyncOlostep)

Basis Web Scraping

Batchverwerking

Slim Web Crawlen

Site Mapping

AI-aangedreven Antwoorden

SDK Referentie

Methode Structuur

Foutafhandeling

Automatische Herhalingen

Geavanceerde Functies

Slimme Input Coercion

Geavanceerde Scraping Opties

Caching

Opslag

Batchverwerking met Aangepaste ID’s

Intelligente Crawling

Site Mapping met Filters

Antwoorden Ophalen

Inhoud Ophalen

Logging

Retry Strategie Configuratie

Standaard Gedrag

Aangepaste Configuratie

Wanneer Herhalingen Plaatsvinden

Transport vs Caller Herhalingen

Berekening van Maximale Duur

Configuratievoorbeelden

Conservatieve Strategie

Agressieve Strategie

Geen Herhalingen (Snel Falen)

Hoge-Throughput Strategie

Begrijpen van Jitter

Best Practices

Voor Productietoepassingen

Voor Ontwikkeling/Testen

Voor Batch Operaties

Monitoring en Debugging

Foutafhandeling

Prestatieoverwegingen

Gedetailleerde Foutafhandeling

Exceptiehiërarchie

Waarom Verbindingfouten Apart Zijn

Aanbevolen Foutafhandeling

Gedetailleerde Foutafhandeling

Configuratie

Omgevingsvariabelen

Hulp Krijgen

Bronnen