API per a agències: què automatitzar

L'API està documentada a la metodologia, amb la seva especificació OpenAPI (pots generar el teu propi client) i amb un entorn de proves sense cost. Els plans del web —Free, Base, Pro— continuen a preus.

No és un requadre obert al web: sense clau del teu compte no hi ha mesurament, i la clau es veu una sola vegada.

1. Llançar l'anàlisi. El mateix perímetre que l'Informe de Captació: web, correu del domini, ressenyes de les fonts vives, fitxa visible i rivals. Idempotència per petició: repetir la mateixa crida no cobra doble.

2. Assabentar-te'n sense refrescar. Avisos signats amb HMAC-SHA256 (pots verificar que l'avís és nostre i que ningú l'ha tocat): anàlisi acabada, anàlisi fallida, quota a prop del límit i avís de prova. El secret es mostra una vegada.

3. Anàlisi en lot. Fins a 20 anàlisis o 50 negocis per crida. Fallada parcial: un ítem malament no tomba el lot ni duplica la despesa.

4. Baixar l'entregable. JSON de l'informe i els PDF de consulta i d'arranjaments. Els PDF no gasten quota.

5. Llegir la quota. Cada resposta autenticada indica quanta quota queda; un excés de ritme respon amb un «torna-ho a provar d'aquí a N segons» explícit. Quota dura: al límit, s'atura.

Hi ha SDK de TypeScript i Python, i un entorn de proves amb dades d'exemple i cost 0. El connector per a assistents d'IA (MCP) és només lectura: un token, un compte, sense escriptura.

No hi ha manera de publicar a la fitxa, contestar una ressenya, fusionar duplicats ni «pujar a Maps». Això no es mesura i no s'opera. La IA del motor no escriu respostes públiques ni contingut que simuli ser teu.

No omplis un «no mesurat» al teu CRM perquè el panell «quedi bonic». La regla és la mateixa que a llegir la matriu.

No disparis vint anàlisis del mateix domini el dia 1 per «escalfar». La memòria cau de 24 h del Radar no gasta; l'abús, sí que es nota a la quota. Aquest producte no és un mesurador de posicions.

Taulers externs i domini propi d'informes no són entre les sortides del web: si els necessites, es parlen al pla Escala (199 €/mes + IVA). L'export CSV de cartera sí que està disponible.

Encaixa si ja tens panell, diverses clíniques o una cartera de tallers, i vols el motor al darrere. Agència cobreix marca blanca i quota (~100/mes) sense API. L'API va amb Escala (199 €/mes + IVA): condicions a mida per sobre, sense permanència.

Sobra si ets el titular d'un local: Free o Base et basten. Sobra si el que vols és que contestem ressenyes. No ho fem. El ritme humà és a respondre sense cremar-te.

A la pràctica, una agència amb cartera fa servir l'API per arrencar l'anàlisi de cada client des del seu propi panell i rebre l'avís quan acaba; el PDF continua sent el lliurable que veu el client. El que l'API no fa és operar la fitxa ni publicar res en el teu nom.

La primera trucada 1:1 és publicada com a gratis: deixar el panell rodant. No és un projecte d'integració a mida.

Permisos tancats per tipus de dada (anàlisis, informes, negocis, avisos, quota). Els errors arriben en un format estàndard que el teu programa entén, sense mentir sobre l'estat. L'encaix comercial a per a agències.

El contacte, al peu d'analitik.es. Sense claus de prova penjades en aquest article.