Skip to main content
Usa l’OpenAPI di Octoparse per gestire le attività, eseguire estrazioni cloud e recuperare programmaticamente i dati raccolti.

​
Autenticazione

Per gli endpoint protetti, il metodo di autenticazione più semplice è una chiave API Octoparse. Crea una chiave nel centro account Octoparse, quindi includila nell’header della richiesta x-api-key. La stessa chiave API può essere usata con l’OpenAPI di Octoparse, il server MCP e la CLI.

Crea o gestisci le chiavi API

Apri la pagina delle chiavi API nel centro account Octoparse.
Le chiavi API in genere iniziano con op_sk_:
Mantieni segreta la chiave API. Non esporla in codice eseguito nel browser, repository pubblici, screenshot o log.
È supportata anche l’autenticazione tramite token di accesso. Ottieni un token di accesso da POST /token, quindi invialo come Authorization: Bearer <access_token>.

​
API AgentTools

L’API AgentTools è un livello di flusso di lavoro basato su modelli e destinato agli agenti AI, costruito sulle API legacy di basso livello per attività, estrazione cloud e dati. Usalo quando un agente o un’automazione deve individuare un modello di scraping adatto, avviare un’esecuzione, seguire le indicazioni del server sui passaggi successivi e recuperare i metadati di esportazione senza collegare direttamente ogni endpoint di basso livello. Flusso per un nuovo scraping:
Flusso per un’attività esistente:
Non conosci ancora AgentTools? Leggi il tutorial completo sul flusso di lavoro per imparare a cercare modelli, avviare un’attività ed esportare i risultati. Le risposte AgentTools mantengono i campi operativi all’interno di data. Usa requestId solo per la risoluzione dei problemi e segui retryGuidance, suggestedNextCall, workflow e toolHint invece di impostare intervalli di polling fissi nel codice.
L’API AgentTools richiede l’autenticazione x-api-key. Alcuni endpoint richiedono anche x-external-user-id; consulta il riferimento di ciascun endpoint per gli header esatti.

​
Prima di iniziare

Per usare l’OpenAPI di Octoparse, è necessario un account Standard, Professionale o Enterprise con almeno un’attività funzionante. Registrati qui se non ne hai ancora uno. Versione API corrente: v1.0

​
URL di base

Tutte le richieste devono essere codificate come URL rispetto all’URL di base:
I segnaposto sono mostrati come {xxxx} e devono essere sostituiti con valori reali. Ad esempio, l’URL della richiesta per Cerca attività è:
Se l’ID del gruppo di attività è abc, l’URL diventa https://openapi.octoparse.com/task/search?taskGroupId=abc.

​
Limiti di frequenza

Octoparse limita l’uso delle API a 20 richieste al secondo. Se ricevi un codice di stato 429, riduci la frequenza delle richieste. Una risposta riuscita restituisce HTTP 200. Per gli altri codici di stato, consulta la sezione Riferimenti di ciascun endpoint.

​
Autorizzazioni

Assicurati che il tuo account disponga dell’autorizzazione necessaria per usare ciascun servizio. In caso contrario, effettua l’upgrade dell’account.

​
Risoluzione dei problemi

Ogni risposta include un requestId. Se una richiesta non riesce, condividi il requestId con il team di assistenza Octoparse per facilitare la diagnosi del problema.