API Capterra Categoria
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Ottieni in JSON i software elencati in una categoria Capterra. Ogni prodotto ha valutazione, numero di recensioni, breve descrizione e dominio del sito web. Passa in category uno slug come accounting-software o l'URL della categoria. Il nome di una singola azienda non funziona, e l'elenco potrebbe non essere completo.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su capterra e action impostato su category. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Capterra Category elenca i prodotti software di una categoria di Capterra, dato il nome breve o l'URL della categoria in category, e restituisce per ogni prodotto nome, link Capterra, valutazione, numero di recensioni, breve descrizione e dominio del sito web. Mostra quali prodotti competono in una categoria e come li valutano i loro utenti. Chi acquista software la usa per creare una rosa di candidati, mentre vendor e analisti la usano per mappare i concorrenti e monitorare la posizione di un prodotto.
category è il percorso della pagina di una categoria, ad esempio project-management-software o accounting-software, oppure l'URL completo della pagina; non è una ricerca a testo libero. Leggi rating insieme a review_count: un punteggio alto basato su una manciata di recensioni dice poco, e un review_count null significa che il numero non è mostrato, non che non ce ne siano. Per leggere le recensioni dietro un punteggio, passa alla funzionalità Capterra Reviews.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Capterra Categoria di EveryInfra (capterra/category).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su capterra e action su category, e inserisci i parametri in params.
- Parametri obbligatori:
- category: Specifica lo slug o l'URL completo di una categoria Capterra, ad esempio project-management-software o accounting-software. Gli slug corrispondono direttamente a https://www.capterra.com/<category>/.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 25)
- Restituisce un elenco di record. Campi principali di ogni record: id, name, url, rating, rating_scale, review_count, description, domain, website.
- Esempio di corpo della richiesta:
{
"platform": "capterra",
"action": "category",
"params": {
"category": "project-management-software"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | capterra | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | category | Identificativo della funzionalità, valore fisso. |
category | body.params | string | Sì | - | Specifica lo slug o l'URL completo di una categoria Capterra, ad esempio project-management-software o accounting-software. Gli slug corrispondono direttamente a https://www.capterra.com/<category>/. Accetta valori di percorso copiati direttamente dalle pagine di categoria, non termini generici di ricerca. |
limit | body.params | integer (1–100) | No | 25 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "capterra",
"action": "category",
"params": {
"category": "project-management-software"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "capterra", "action": "category", "results": [ { "id": "svc-nj55wm2i", "name": "ClockShark", "url": "https://www.capterra.com/p/155467/ClockShark/", "rating": 4.7, "review_count": 1911, "description": "Field project management connects jobs, tasks, schedules and crew hours in one shared workflow.", "domain": "clockshark.com", "website": "https://www.clockshark.com/", "platform": "capterra", "rating_scale": 5 }, { "id": "svc-scku531j", "name": "Accelo", "url": "https://www.capterra.com/p/225762/Accelo/", "rating": 4.5, "review_count": 178, "description": "Accelo connects project delivery to profitability with AI predicting risks, tracking budgets, and surfacing scope creep in real time.", "domain": "accelo.com", "website": "https://www.accelo.com/", "platform": "capterra", "rating_scale": 5 } ], "count": 25, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
url | Link al record sulla piattaforma. |
rating | Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito. |
rating_scale | Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione. |
review_count | Numero di recensioni, per le funzionalità relative a prodotti e attività. null significa non reso noto, non 0. |
description | Riepilogo o descrizione, di solito più breve di text. |
domain | Mantiene il significato attribuito dalla piattaforma |
website | Sito web esterno indicato dall'account o dall'attività. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Restituisce anche le recensioni stesse?
#No. Elenca i prodotti con rating e review_count. Per le recensioni usa la funzionalità Capterra Reviews: accetta il nome di un prodotto o il suo link Capterra nella forma /p/<product ID>/<product slug>/, e il link evita confusioni tra prodotti con lo stesso nome. Quando l'url di una riga ha quella forma, passalo così com'è.
Dove trovo il nome della categoria?
#Apri la categoria su Capterra e copia il percorso dopo capterra.com/, ad esempio project-management-software, oppure passa l'URL completo della pagina. Un nome breve viene trasformato in https://www.capterra.com/<category>/, quindi funziona qualsiasi pagina di categoria, non solo gli esempi di questa pagina. Le frasi a testo libero non sono nomi di categoria.
Come confronto le valutazioni di Capterra con quelle di altri siti di recensioni?
#Prima normalizzale. rating_scale su ogni riga indica il valore massimo di rating, e non tutti i siti di recensioni usano lo stesso massimo, quindi dividi per quel valore prima di confrontare. Poi pondera ogni punteggio in base a review_count, perché un prodotto valutato da qualche decina di utenti si basa su dati più scarsi rispetto a uno valutato da migliaia.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.