• Instrumente SEO

API-ul Rank Tracker

  • Felix Rose-Collins
  • 18 min read

Introducere

Urmărirea pozițiilor devine o problemă cu totul diferită atunci când gestionați sute de site-uri web, mii de cuvinte cheie sau rapoarte SEO care trebuie actualizate automat.

Conectarea la un panou de control și exportarea manuală a datelor pot funcționa pentru proiecte mai mici. La scară largă, acest proces devine rapid un obstacol.

De aceea am creat API-ul Ranktracker.

API-ul Ranktracker este acum disponibil și oferă dezvoltatorilor, echipelor de SEO, agențiilor, companiilor SaaS și echipelor de date acces programatic la datele lor din Ranktracker.

Puteți utiliza API-ul pentru:

  • Recuperează clasamentele celor mai bune 100 de cuvinte cheie
  • Accesați datele SERP
  • Detectează prezentările generale AI și alte caracteristici SERP
  • Crearea și gestionarea domeniilor monitorizate
  • Adăugați și gestionați cuvintele cheie
  • Urmăriți concurenții
  • Accesați istoricul clasamentelor
  • Calculați cota de voce
  • Organizați cuvintele cheie folosind etichete
  • Monitorizați utilizarea contului și cota
  • Creați fluxuri automatizate de raportare SEO
  • Conectează datele privind clasamentul la aplicațiile și tablourile de bord interne

În loc să transferați manual datele SEO între platforme, API-ul Ranktracker permite propriului dvs. software să interacționeze direct cu infrastructura de clasificare din spatele Ranktracker.

Creați sau gestionați cheia API: https://app.ranktracker.com/account/api

Faceți cunoștință cu Ranktracker

Platforma All-in-One pentru un SEO eficient

În spatele fiecărei afaceri de succes se află o campanie SEO puternică. Dar, având în vedere că există nenumărate instrumente și tehnici de optimizare din care puteți alege, poate fi greu să știți de unde să începeți. Ei bine, nu vă mai temeți, pentru că am exact ceea ce vă poate ajuta. Vă prezentăm platforma Ranktracker all-in-one pentru un SEO eficient

Am deschis în sfârșit înregistrarea la Ranktracker absolut gratuit!

Creați un cont gratuit

Sau Conectați-vă folosind acreditările dvs.

Citiți documentația API-ului: https://developers.ranktracker.com/

Ce este API-ul Ranktracker?

API-ul API-ul Ranktracker este un API REST care oferă acces programatic la contul dvs. Ranktracker.

În loc să deschideți Ranktracker de fiecare dată când aveți nevoie de informații despre clasament, aplicația dvs. poate solicita datele automat.

API-ul este structurat în jurul acelorași resurse de bază utilizate în întregul Ranktracker:

  • Conturi
  • Domenii
  • Cuvinte cheie
  • Concurenți
  • Istoric de clasare
  • Date SERP
  • Cota de voce
  • Etichete
  • Utilizare și cotă

Acest lucru le oferă dezvoltatorilor posibilitatea atât de a prelua date din Ranktracker, cât și de a gestiona elementele pe care Ranktracker le monitorizează.

De exemplu, o agenție de SEO ar putea crea automat un proiect Ranktracker atunci când un client nou este înregistrat în sistemul său CRM, ar putea adăuga cuvintele cheie și concurenții clientului, iar apoi ar putea integra clasamentele acestora într-un tablou de bord intern de raportare.

O platformă SaaS ar putea utiliza același API pentru a afișa datele privind clasamentul direct în cadrul propriului produs.

O echipă de date ar putea trimite automat clasamentele zilnice în BigQuery, Snowflake, PostgreSQL, Google Sheets sau un alt depozit de date pentru analize ulterioare.

Faceți cunoștință cu Ranktracker

Platforma All-in-One pentru un SEO eficient

În spatele fiecărei afaceri de succes se află o campanie SEO puternică. Dar, având în vedere că există nenumărate instrumente și tehnici de optimizare din care puteți alege, poate fi greu să știți de unde să începeți. Ei bine, nu vă mai temeți, pentru că am exact ceea ce vă poate ajuta. Vă prezentăm platforma Ranktracker all-in-one pentru un SEO eficient

Am deschis în sfârșit înregistrarea la Ranktracker absolut gratuit!

Creați un cont gratuit

Sau Conectați-vă folosind acreditările dvs.

Pentru o prezentare generală a modului în care se integrează resursele, consultați Ghidul „Conceptele de bază ale API-ului Ranktracker”.

Top 100 clasamente în mod implicit

Unul dintre cele mai mari avantaje ale API-ului Ranktracker este profunzimea datelor privind clasamentele.

Fiecare verificare a cuvintelor cheie include, în mod implicit, primele 100 de rezultate Google.

Asta înseamnă că puteți analiza toate cele 10 pagini de rezultate ale căutării, în loc să vedeți doar ce se clasează în prezent pe prima pagină.

Acest lucru este important deoarece progresul SEO începe, de obicei, cu mult înainte ca un cuvânt cheie să ajungă în Top 10.

Un cuvânt cheie se poate deplasa:

Poziția 91 → Poziția 63 → Poziția 37 → Poziția 18 → Poziția 9

Acest lucru reprezintă un progres semnificativ în materie de SEO.

Dacă datele dvs. de clasare se opresc la primele 10 rezultate, aproape întregul parcurs rămâne invizibil.

Urmărirea primelor 100 de poziții vă permite să monitorizați:

  • Noi clasări care intră în Top 100 Google
  • Cuvinte cheie care avansează spre prima pagină
  • Creșteri și scăderi semnificative în clasament
  • Mișcările concurenților
  • Vizibilitatea căutărilor de tip „long-tail”
  • Performanța conținutului nou
  • Campanii SEO programatice
  • Portofolii mari de cuvinte cheie

Acest lucru face ca API-ul să fie util atât pentru raportarea SEO la nivel înalt, cât și pentru analiza detaliată a clasamentului.

Aflați mai multe despre API:

https://developers.ranktracker.com/

Urmăriți clasamentele în peste 107.000 de locații

Rezultatele căutării variază semnificativ în funcție de locul în care se efectuează căutarea.

Ranktracker acceptă peste 107.000 de locații, oferind echipelor posibilitatea de a urmări vizibilitatea în căutările locale, naționale și internaționale prin intermediul API-ului.

Urmărirea cuvintelor cheie poate fi configurată în funcție de factori precum:

  • Motor de căutare
  • Locație
  • Limba
  • Dispozitiv

De exemplu, același cuvânt cheie ar putea fi monitorizat separat pentru:

  • Statele Unite — desktop
  • Statele Unite — mobil
  • Marea Britanie — desktop
  • Germania — mobil
  • Polonia — desktop

Fiecare configurație poate fi tratată ca un cuvânt cheie urmărit separat.

Acest lucru este deosebit de util pentru:

  • SEO internațional
  • Companii cu mai multe locații
  • Agenții locale de SEO
  • Companii de comerț electronic
  • Editori care activează pe diferite piețe
  • Companii SaaS care vizează mai multe țări
  • Echipe de SEO la nivel de întreprindere

În loc să tratați un cuvânt cheie ca având o singură poziție universală în clasament, puteți analiza modul în care vizibilitatea se modifică pe diferite piețe și dispozitive.

Urmărirea clasamentului pe desktop și pe mobil

Rezultatele căutărilor pe desktop și pe dispozitive mobile pot diferi.

Prin urmare, Ranktracker permite segmentarea monitorizării cuvintelor cheie în funcție de dispozitiv.

Aceasta înseamnă că o integrare poate analiza separat:

  • Clasamente pe desktop
  • Clasamente pe dispozitive mobile

De exemplu, o pagină poate ocupa o poziție înaltă în clasament pe desktop, dar poate avea performanțe diferite pe mobil din cauza diferențelor în aspectul SERP, a rezultatelor locale sau a altor funcții de căutare.

Păstrarea separată a acestor seturi de date oferă echipelor de SEO o imagine mult mai clară a modului în care utilizatorii întâlnesc efectiv site-urile lor în rezultatele căutării.

API-ul permite, de asemenea, segmentarea pe dispozitive atunci când se lucrează cu funcții precum „Share of Voice”.

Prezentare generală a funcțiilor SERP și a detectării AI

Rezultatele moderne ale Google conțin mult mai mult decât listările organice tradiționale.

SERP-urile pot include:

  • Prezentări generale bazate pe IA
  • Fragmente recomandate
  • Hărți
  • Rezultate locale
  • Videoclipuri
  • Rezultate de cumpărături
  • Întrebări frecvente
  • Alte funcții de căutare

API-ul Ranktracker include informații despre funcțiile SERP și detectarea AI Overview, alături de datele privind cuvintele cheie.

Asta înseamnă că integrarea dvs. poate analiza nu doar poziția unui site web, ci și ce anume înconjoară acea poziție în Google.

De exemplu, ați putea identifica:

  • Cuvinte cheie care declanșează o prezentare generală AI
  • Pagini cu rezultate de căutare (SERP) care conțin fragmente recomandate
  • Căutări dominate de rezultate video
  • Cuvinte cheie care generează rezultate locale sau pe hartă
  • Modificări în compoziția SERP-urilor de-a lungul timpului

Acest lucru este din ce în ce mai important, deoarece poziția organică, luată separat, nu spune întotdeauna întreaga poveste.

O pagină care ocupă locul al treilea într-un SERP tradițional și o pagină care ocupă locul al treilea sub o prezentare generală generată de IA, un pachet de hărți, videoclipuri și secțiunea „Oamenii mai întreabă” pot beneficia de niveluri de vizibilitate foarte diferite.

API-ul permite ca aceste diferențe să fie incluse în analiza dvs. SEO.

Consultați documentația completă a API-ului:

https://developers.ranktracker.com/

Accesați datele complete din SERP

Ranktracker poate oferi mult mai mult decât o simplă poziție în clasament.

Pentru cuvintele cheie monitorizate, API-ul poate afișa cele mai recente rezultate ale căutării împreună cu informațiile SERP asociate.

Structura resurselor API include:

  • Cele mai recente date privind SERP
  • Informații privind clasamentul
  • Caracteristici SERP
  • Cod HTML SERP stocat în cache

Acest lucru înseamnă că dezvoltatorii pot crea fluxuri de lucru bazate pe rezultatele reale ale căutării, în loc să stocheze pur și simplu ceva de genul:

Poziția: 12

Pentru echipele avansate de SEO, acest lucru oferă mult mai multă flexibilitate.

Puteți utiliza informațiile SERP pentru:

  • Analizați URL-urile concurente
  • Investigați schimbările neașteptate de clasare
  • Identificarea modificărilor aduse aspectului rezultatelor
  • Crearea de instrumente interne de analiză SERP
  • Stocarea informațiilor istorice privind SERP
  • Introduceți informațiile privind rezultatele căutării în alte modele sau sisteme de analiză

Referința completă a punctelor finale poate fi găsită aici:

https://developers.ranktracker.com/rest-api/

Gestionarea domeniilor prin API

Domeniile reprezintă una dintre resursele esențiale ale API-ului Ranktracker.

API-ul REST vă permite să:

  • Creați domenii
  • Recuperarea domeniilor
  • Actualizarea domeniilor
  • Ștergerea domeniilor

Un domeniu reprezintă un site monitorizat în cadrul Ranktracker.

Fiecare domeniu poate conține propriile:

  • Cuvinte cheie
  • Concurenți
  • Istoric de clasare
  • Date privind cota de voce

Acest lucru face posibilă integrarea automată.

De exemplu, o agenție ar putea crea următorul flux de lucru:

Un client nou se înregistrează
        ↓
Se creează un domeniu Ranktracker
        ↓
Se adaugă cuvintele cheie ale clientului
        ↓
Se adaugă concurenții
        ↓
Se începe monitorizarea pozițiilor
        ↓
Se trimit datele către tabloul de bord de raportare

Nu este necesar ca un membru al echipei să configureze manual fiecare proiect nou.

Un ghid complet este disponibil în tutorialul tutorialul „Adăugarea unui domeniu și urmărirea cuvintelor cheie”.

Adăugarea și gestionarea cuvintelor cheie prin programare

Odată ce un domeniu există, cuvintele cheie pot fi gestionate prin intermediul API-ului.

Puteți utiliza API-ul pentru a adăuga cuvinte cheie urmărite, specificând în același timp configurația de căutare asociată acestora.

Datele privind cuvintele cheie urmărite pot include factori precum:

  • Cuvânt
  • Motor de căutare
  • Locație
  • Limba
  • Dispozitiv
  • Rezultate de clasificare

De asemenea, puteți gestiona ciclul de viață al cuvintelor cheie existente.

Aceasta include posibilitatea de a:

  • Căutare după cuvinte cheie
  • Citiți informațiile despre clasament
  • Pauză urmărire
  • Reia urmărirea
  • Oprire urmărire
  • Accesarea informațiilor SERP
  • Atribuiți etichete

Astfel, propria dvs. aplicație poate controla ce cuvinte cheie monitorizează Ranktracker.

Urmărirea în bloc a cuvintelor cheie

Conturile SEO de mari dimensiuni nu ar trebui să fie nevoite să efectueze o cerere API pentru fiecare cuvânt cheie.

Ranktracker acceptă operațiuni în bloc cu cuvinte cheie.

Punctul final de creare a cuvintelor cheie acceptă o configurație de tip „cuvinte × motoare de căutare”, permițând crearea mai multor combinații de cuvinte cheie monitorizate într-o singură solicitare.

De exemplu, imaginați-vă că doriți să monitorizați:

  • 100 de cuvinte cheie
  • Desktop SUA
  • Dispozitive mobile din SUA

Aceste configurații pot genera 200 de combinații de cuvinte cheie urmărite fără a fi necesare 200 de cereri individuale de configurare.

Operațiunile în bloc sunt deosebit de utile pentru:

  • Agenții
  • SEO pentru întreprinderi
  • Magazine de comerț electronic de mari dimensiuni
  • SEO programatic
  • Platforme SEO de tip SaaS
  • Editori mari de conținut

Ranktracker acceptă, de asemenea, etichetarea în bloc a cuvintelor cheie.

Citiți ghidul complet privind operațiunile în bloc:

https://developers.ranktracker.com/guides/bulk-operations/

Urmăriți concurenții SEO

Clasamentele devin mult mai utile atunci când includ contextul concurențial.

API-ul Ranktracker permite gestionarea concurenților în raport cu domeniile monitorizate.

Astfel, puteți analiza automat performanța dvs. în căutări în comparație cu site-urile concurente.

Puteți utiliza datele concurenților pentru a monitoriza:

  • Care sunt concurenții care câștigă vizibilitate
  • Ce site-uri depășesc domeniul tău
  • Modificări la nivelul grupurilor de cuvinte cheie comune
  • Tendințe de clasare în raport cu concurența
  • Vizibilitatea relativă în căutări
  • Modificări ale cotei de voce

Pentru agenții, acest lucru poate deveni parte a unui sistem automatizat de raportare către clienți.

În loc să comparați manual un client cu concurenții în fiecare lună, datele relevante pot fi integrate direct în fluxul de raportare.

Acces la datele istorice privind clasamentul

Clasamentele actuale arată doar ce se întâmplă în prezent.

Datele istorice privind clasamentul indică direcția în care evoluează performanța SEO.

Ranktracker oferă istoricul clasamentului domeniilor prin intermediul API-ului, permițând dezvoltatorilor să analizeze vizibilitatea în timp.

Datele istorice pot ajuta la identificarea:

  • Creșteri în clasament
  • Pierderi de clasare
  • Tendințe de vizibilitate
  • Evoluția cuvintelor cheie
  • Modificări după campaniile SEO
  • Impactul actualizărilor Google
  • Performanța campaniilor pe termen lung

De asemenea, puteți utiliza istoricul clasamentelor pentru a crea grafice și tablouri de bord personalizate.

De exemplu:

API-ul Ranktracker
       ↓
Extragerea zilnică a clasamentelor
       ↓
Depozitul de date
       ↓
Setul de date istorice SEO
       ↓
Tablou de bord / Alerte / Analiză

Ranktracker oferă un tutorial dedicat care arată cum se pot importa clasamentele zilnice într-un depozit de date:

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Trimiterea datelor Ranktracker către un depozit de date

Unul dintre cele mai utile fluxuri de lucru API este stocarea automată a datelor Ranktracker în propria bază de date sau depozit de date.

De exemplu, datele privind clasamentele ar putea fi trimise către:

  • BigQuery
  • Snowflake
  • PostgreSQL
  • MySQL
  • Google Sheets
  • Baze de date interne de analiză

Aceste informații pot fi apoi combinate cu alte date de afaceri.

De exemplu:

Ranktracker
     ↓
API-ul Ranktracker
     ↓
Depozitul de date
     ↓
Google Search Console
Analytics
Conversii
Venituri
Date CRM
     ↓
Tablou de bord de business intelligence

Astfel se obține o imagine mult mai detaliată a performanței SEO.

În loc să știi pur și simplu că un cuvânt cheie a urcat de pe poziția 8 pe poziția 3, ai putea analiza dacă această schimbare a dus și la:

  • Mai multe clicuri organice
  • Mai mulți clienți potențiali
  • Rate de conversie mai mari
  • Venituri mai mari

Tutorialul Tutorialul „De la clasamente la depozitul de date” oferă un exemplu de construire a acestui tip de flux de date.

Crearea rapoartelor privind cota de voce

API-ul Ranktracker pune la dispoziție și date privind cota de voce.

„Share of Voice” oferă o măsură mai cuprinzătoare a vizibilității unui domeniu în cadrul unui set de cuvinte cheie monitorizate.

În loc să întrebați:

Pe ce poziție ne situăm pentru acest cuvânt cheie?

puteți întreba:

Cât de vizibili suntem pe întreaga piață de căutare?

Acest lucru devine deosebit de util atunci când sunt incluse datele concurenților.

API-ul Share of Voice poate fi utilizat pentru a analiza:

  • Vizibilitatea ta generală
  • Vizibilitatea concurenților
  • Modificări ale vizibilității în timp
  • Poziția relativă pe piață
  • Vizibilitatea pe desktop
  • Vizibilitatea pe dispozitive mobile

Punctul final acceptă intervale de date și segmentarea pe dispozitive, permițând integrarea Share of Voice în rapoarte SEO personalizate.

Un exemplu complet de implementare este disponibil aici:

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Organizați cuvintele cheie cu ajutorul etichetelor

Portofoliile mari de cuvinte cheie devin dificil de gestionat fără o organizare adecvată.

Ranktracker oferă etichete la nivel de cont care pot fi atașate cuvintelor cheie urmărite.

Puteți crea etichete pentru:

  • Categorii de produse
  • Intenția de căutare
  • Locații
  • Tipuri de conținut
  • Campanii
  • Clienți
  • Etape ale procesului de conversie
  • Unități de afaceri
  • Echipe SEO

De exemplu:

„cumpăra pantofi de alergare” → Comercial
„cei mai buni pantofi de alergare” → Comparație
„cum se curăță pantofii de alergare” → Informațional

Aceleași etichete pot fi reutilizate în diferite domenii și grupuri de cuvinte cheie.

Ranktracker oferă, de asemenea, etichetare în bloc, astfel încât grupurile mari de cuvinte cheie să poată fi organizate fără a fi necesare solicitări individuale.

Un tutorial dedicat este disponibil aici:

https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Monitorizarea utilizării contului și a cotei

Sistemele automatizate trebuie, de asemenea, să înțeleagă resursele contului de care dispun.

API-ul Ranktracker oferă:

GET /v1/account/usage

Acest punct final raportează utilizarea și limitele contului.

Informațiile privind utilizarea curentă pot include:

  • Starea accesului la API
  • Cuvinte cheie
  • Rânduri de date
  • Utilizare la cerere
  • Utilizarea SERP Analyser

Fiecare cotă poate furniza valori precum:

  • Utilizare
  • Limită
  • Rămase

Acest lucru permite unei aplicații să verifice capacitatea disponibilă înainte de a începe o operațiune de amploare.

De exemplu, înainte de a importa mii de cuvinte cheie, sistemul dvs. poate interoga utilizarea contului și poate determina câtă capacitate mai rămâne.

Citiți ghidul complet:

https://developers.ranktracker.com/guides/usage-and-quota/

Cum funcționează autentificarea API-ului Ranktracker

Solicitările API-ului REST Ranktracker sunt autentificate folosind o cheie API.

Puteți crea și gestiona cheile direct în Ranktracker:

https://app.ranktracker.com/account/api

Cheia API trebuie tratată întotdeauna ca o parolă.

URL-ul de bază al API-ului de producție este:

https://api.ranktracker.com

Resursele API se află sub calea /v1.

De exemplu:

https://api.ranktracker.com/v1/domains

Cheia API este trimisă direct în antetul „Authorization ”.

Nu există prefixul „Bearer” pentru cererile standard ale API-ului REST.

Exemplu:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

O cheie API Ranktracker trebuie păstrată pe server și nu trebuie niciodată expusă prin:

  • JavaScript pentru browser
  • Cod sursă front-end
  • Repozitorii publice
  • Codul aplicației mobile
  • Fișiere de configurare publice

Pentru mai multe informații, citiți:

Ghid de pornire rapidă: https://developers.ranktracker.com/guides/quickstart/

Autentificare: https://developers.ranktracker.com/guides/authentication/

Crearea/gestionarea cheilor API: https://app.ranktracker.com/account/api

Structura resurselor API

Ranktracker utilizează UUID-uri pentru a identifica resursele.

Acestea includ resurse precum:

  • Domenii
  • Cuvinte cheie
  • Concurenți
  • Etichete

O reprezentare simplificată arată astfel:

Cont
│
├── Utilizare
├── Etichete
│
└── Domenii
    │
    ├── Istoric clasament
    ├── Cota de voce
    ├── Concurenți
    │
    └── Cuvinte cheie
        │
        ├── SERP
        ├── SERP HTML în cache
        └── Etichete

Acest lucru face ca structura API-ului să fie previzibilă.

Un domeniu are cuvinte cheie și concurenți.

Un cuvânt cheie aparține unui domeniu monitorizat și are asociate informații despre SERP și clasament.

Etichetele există la nivel de cont și pot fi asociate cuvintelor cheie.

Citește mai mult:

https://developers.ranktracker.com/guides/concepts/

Răspunsuri API JSON

Răspunsurile Ranktracker utilizează un format consistent de tip JSON:API.

Resursa este returnată sub „data”, în timp ce câmpurile sale sunt stocate sub „attributes”.

De exemplu:

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Example",
      "matchType": "any"
    }
  }
}

De asemenea, dezvoltatorii trebuie să țină cont de o convenție importantă de denumire:

  • Răspunsurile API utilizează camelCase
  • Corpul cererilor de scriere utilizează snake_case

De exemplu, un răspuns ar putea include:

projectName

în timp ce o cerere de scriere utilizează:

project_name

Această convenție se aplică în întreaga API.

A se vedea:

https://developers.ranktracker.com/guides/concepts/

Paginare

Punctele finale ale listei sunt paginate, astfel încât aplicațiile să poată funcționa eficient cu conturi Ranktracker de mari dimensiuni.

Paginarea se aplică resurselor, inclusiv:

  • Domenii
  • Cuvinte cheie
  • Concurenți
  • Etichete

Cei doi parametri principali sunt:

  • pagină
  • pe_pagină

per_page acceptă până la 1.000 de înregistrări pe pagină.

Informațiile de paginare sunt returnate prin anteturile de răspuns, inclusiv:

  • X-Total-Count
  • X-Număr total de pagini
  • X-Pe-pagină
  • X-Pagina-curentă

Prin urmare, în cazul exporturilor de dimensiuni mari, aplicațiile pot continua să solicite pagini până când setul complet de date a fost recuperat.

Citiți ghidul de paginare:

https://developers.ranktracker.com/guides/pagination/

Gestionarea erorilor și limitele de rată

API-ul Ranktracker utilizează coduri de stare HTTP standard pentru a facilita gestionarea erorilor la nivel de programare.

Răspunsurile obișnuite includ:

StareSemnificațieExemplu
400Cerere incorectăLipsește un parametru obligatoriu sau acesta este incorect format
402Cota depășităOperațiunea solicitată ar depăși limita alocată contului
403InterzisSolicitarea nu este autorizată sau accesul la API nu este disponibil
404Nu a fost găsitResursa nu există în cont
422Eroare de validareSolicitarea este în format JSON valid, dar conține date nevalide
429Prea multe solicităriIntegrarea a fost limitată ca frecvență

Atunci când apare un răspuns 429, integrările ar trebui să respecte informațiile Retry-After returnate înainte de a încerca din nou.

Acest lucru permite aplicațiilor de producție să gestioneze limitările temporare fără a eșua pur și simplu.

Documentația completă privind erorile și limitele de rată este disponibilă aici:

https://developers.ranktracker.com/guides/errors-and-rate-limits/

API-ul REST Ranktracker vs MCP

API-ul REST nu este singura modalitate de a conecta software-ul extern la Ranktracker.

Ranktracker oferă, de asemenea, un server MCP găzduit.

MCP înseamnă Model Context Protocol și permite aplicațiilor și agenților AI compatibili să lucreze direct cu datele Ranktracker.

Printre aceștia se numără clienți compatibili precum:

  • ChatGPT
  • Claude
  • Cursor
  • Alte aplicații AI compatibile cu MCP

REST și MCP interacționează cu aceleași date Ranktracker subiacente, dar sunt concepute pentru fluxuri de lucru diferite.

API REST RanktrackerMCP Ranktracker
Ideal pentruAplicații, tablouri de bord, depozite de date și sarcini programateAsistenți și agenți AI
ApelantBackend-ul dvs. sau clientul HTTPChatGPT, Claude, Cursor sau un alt client MCP
InterfațăPuncte finale RESTInstrumente MCP
Calea REST/v1/.../mcp
Utilizare tipicăMutarea și gestionarea automată a datelor SEOExplorarea datelor SEO într-un mod conversațional

De exemplu, REST este o alegere mai potrivită dacă doriți să:

  • Exportă clasamentele în fiecare noapte
  • Actualizează un tablou de bord BI
  • Crearea automată a proiectelor SEO
  • Adăugarea cuvintelor cheie din aplicația dvs.
  • Sincronizarea datelor privind clasamentul cu o bază de date

MCP este mai potrivit pentru întrebări precum:

Care dintre cuvintele cheie pe care le monitorizez au înregistrat cea mai mare scădere săptămâna aceasta?

sau:

Care dintre concurenți au câștigat cea mai mare vizibilitate?

Un client AI poate selecta instrumentul Ranktracker adecvat și poate interoga datele relevante.

Multe echipe avansate de SEO pot utiliza ambele.

REST se ocupă de infrastructură și automatizare. MCP pune datele Ranktracker la dispoziția agenților de IA.

Aflați mai multe:

Prezentare generală MCP: https://developers.ranktracker.com/mcp/

Conectarea unui client MCP: https://developers.ranktracker.com/mcp/connect/

Referințe privind instrumentul MCP: https://developers.ranktracker.com/mcp/tools/

Ce puteți crea cu API-ul Ranktracker?

API-ul Ranktracker poate fi utilizat pentru mult mai mult decât afișarea poziției unui cuvânt cheie.

Iată câteva dintre cele mai utile aplicații.

Raportare SEO automatizată

O agenție poate prelua automat informațiile privind clasamentul în propria sa platformă de raportare.

În loc de:

Deschide Ranktracker
↓
Exportă CSV
↓
Editează foaia de calcul
↓
Încarcă raportul
↓
Trimite clientului

puteți crea:

API Ranktracker
↓
Platforma de raportare
↓
Raportul clientului actualizat automat

Acest lucru este deosebit de util pentru agențiile care gestionează un număr mare de clienți.

Tablouri de bord SEO personalizate

Este posibil ca firma dumneavoastră să utilizeze deja o platformă internă de raportare sau de business intelligence.

API-ul permite ca datele Ranktracker să devină o altă sursă de date în cadrul acelui mediu.

Puteți crea tablouri de bord care afișează:

  • Clasamentele cuvintelor cheie
  • Modificări ale clasamentului
  • Top 3 cuvinte cheie
  • Top 10 cuvinte cheie
  • Top 100 cuvinte cheie
  • Cota de vizibilitate
  • Vizibilitatea concurenților
  • Funcții SERP
  • Apariții în Prezentarea generală AI

Tabloul de bord rezultat poate fi adaptat în mod specific la nevoile de raportare ale companiei dumneavoastră.

Integrarea automată a clienților

Agențiile de SEO pot integra Ranktracker în procesul de integrare a clienților.

De exemplu:

Clientul cumpără un pachet SEO
↓
CRM creează un client
↓
API-ul Ranktracker creează un domeniu
↓
Se adaugă cuvintele cheie
↓
Se adaugă concurenții
↓
Începe monitorizarea

Acest lucru elimină configurarea manuală repetitivă a proiectelor.

Baze de date SEO

Clasamentele devin mai valoroase atunci când sunt corelate cu alte date de marketing și de afaceri.

Informațiile Ranktracker pot fi combinate cu:

  • Google Search Console
  • Analize
  • Date CRM
  • Date privind conversiile
  • Venituri din comerțul electronic
  • Date privind clienții potențiali
  • Performanța conținutului

Acest lucru poate ajuta la răspunsul la întrebări mult mai importante decât simpla verificare a unui clasament.

De exemplu:

Care îmbunătățiri ale clasamentului au generat cele mai mari venituri?

sau:

Care grupuri de cuvinte cheie cresc vizibilitatea, dar nu generează conversii?

Alertele privind clasamentul

Datele istorice privind clasamentul pot alimenta, de asemenea, sisteme personalizate de alerte.

O integrare ar putea detecta automat când:

  • Un cuvânt cheie iese din Top 3
  • O pagină intră în Top 10
  • Un cuvânt cheie intră în Top 100
  • Un cuvânt cheie important dispare din Top 100
  • Un concurent depășește site-ul dvs.
  • Vizibilitatea în căutări scade brusc

Alerte ar putea fi apoi trimise către adresa dvs. de e-mail, Slack, tabloul de bord intern sau sistemul de monitorizare.

Informații despre concurență

Combinarea:

  • Clasamente
  • Urmărirea concurenților
  • Istoric de clasare
  • Cota de voce

se creează baza pentru un sistem automatizat de monitorizare SEO a concurenței.

În loc să evaluați concurenții o dată la câteva luni, vizibilitatea lor în căutări poate deveni un indicator monitorizat continuu.

Monitorizarea programatică a SEO

SEO-ul programatic poate genera mii sau sute de mii de pagini de destinație.

Monitorizarea manuală a acestor proiecte este imposibilă.

API-ul Ranktracker permite dezvoltatorilor să creeze fluxuri de lucru de clasare capabile să gestioneze seturi mari de date cu cuvinte cheie și să transfere automat informațiile rezultate în sistemele interne de analiză.

Analiza SEO bazată pe IA

API-ul REST și serverul MCP ale Ranktracker pot deveni, de asemenea, parte a fluxurilor de lucru SEO bazate pe IA.

De exemplu, sistemele de IA ar putea ajuta:

  • Identificarea scăderilor în clasament
  • Rezumatul modificărilor de clasament
  • Identificarea cuvintelor cheie cu creștere rapidă
  • Compară vizibilitatea concurenților
  • Analizați modificările din SERP
  • Prioritizați oportunitățile SEO
  • Generați rapoarte interne
  • Investigați mișcările neobișnuite în clasament

API-ul furnizează datele structurate, în timp ce IA poate ajuta la interpretarea acestora.

Cui se adresează API-ul Ranktracker?

API-ul Ranktracker este deosebit de util pentru:

  • Agenții de SEO
  • Echipe SEO din cadrul întreprinderilor
  • Companii SaaS
  • Companii de software SEO
  • Dezvoltatori
  • Ingineri de date
  • Echipe de BI
  • Companii de comerț electronic
  • Specialiști în marketing de afiliere
  • Editori
  • Companii cu mai multe sedii
  • Echipe de SEO programatic
  • Echipe de automatizare bazată pe IA

Dacă datele de clasare trebuie recuperate, mutate, analizate sau gestionate automat, un API este de obicei o soluție mult mai scalabilă decât exporturile manuale.

De ce să folosiți Ranktracker în loc să vă construiți propria infrastructură de monitorizare a clasamentelor?

Colectarea clasamentelor de căutare la scară largă implică mult mai mult decât efectuarea unei căutări pe Google.

Un sistem de monitorizare a clasamentelor în producție trebuie să țină cont de:

  • Locații
  • Limbi
  • Dispozitive
  • Colecția celor mai bune 100 de rezultate
  • Caracteristici SERP
  • Prezentări generale AI
  • Configurarea cuvintelor cheie
  • Date istorice privind clasamentul
  • Concurenți
  • Programare
  • Modificări ale rezultatelor căutării
  • Stocarea datelor
  • Raportare

Construirea și întreținerea întregii infrastructuri la nivel intern poate necesita resurse semnificative de dezvoltare.

Ranktracker se ocupă de infrastructura de monitorizare a clasamentelor și pune la dispoziție datele rezultate printr-un API structurat.

Prin urmare, dezvoltatorii dvs. se pot concentra pe crearea aplicației, a tabloului de bord, a fluxului de lucru sau a analizei de care afacerea dvs. are nevoie cu adevărat.

Cum să începeți să utilizați API-ul Ranktracker

Pentru a începe, sunt necesari doar câțiva pași.

1. Deschideți setările API-ului

Accesați direct:

https://app.ranktracker.com/account/api

Creați o cheie API și păstrați-o în siguranță.

2. Citiți ghidul de pornire rapidă

Urmați ghidul oficial de pornire rapidă:

https://developers.ranktracker.com/guides/quickstart/

3. Efectuați prima solicitare

De exemplu:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

4. Explorați referința API

Referința completă a API-ului REST este disponibilă aici:

https://developers.ranktracker.com/rest-api/

5. Începeți configurarea

De aici puteți începe să conectați Ranktracker la:

  • Aplicația dvs.
  • Stiva dvs. de raportare
  • Depozitul dvs. de date
  • CRM-ul dumneavoastră
  • Instrumentele dumneavoastră interne
  • Fluxurile dvs. de lucru bazate pe IA

Documentația API-ului Ranktracker

Documentația completă pentru dezvoltatori poate fi găsită la:

Documentația pentru dezvoltatori: https://developers.ranktracker.com/

Crearea și gestionarea cheilor API: https://app.ranktracker.com/account/api

Ghid de pornire rapidă: https://developers.ranktracker.com/guides/quickstart/

Autentificare: https://developers.ranktracker.com/guides/authentication/

Concepte de bază: https://developers.ranktracker.com/guides/concepts/

Paginare: https://developers.ranktracker.com/guides/pagination/

Erori și limite de rată: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Utilizare și cote: https://developers.ranktracker.com/guides/usage-and-quota/

Operațiuni în bloc: https://developers.ranktracker.com/guides/bulk-operations/

Tutorial privind urmărirea unui domeniu: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Tutorial privind clasamentele către depozitul de date: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Tutorial privind cota de voce: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Tutorial privind etichetarea în bloc: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Referință API REST: https://developers.ranktracker.com/rest-api/

Server MCP: https://developers.ranktracker.com/mcp/

Conectarea unui client MCP: https://developers.ranktracker.com/mcp/connect/

Referință pentru instrumentul MCP: https://developers.ranktracker.com/mcp/tools/

Începeți să creați cu API-ul Ranktracker

API-ul Ranktracker transformă Ranktracker dintr-un panou de control SEO într-o infrastructură care se poate integra direct în stiva dvs. tehnologică.

Îl puteți utiliza pentru a gestiona domenii și cuvinte cheie, a urmări concurenții, a prelua clasamentele Top 100, a analiza SERP-urile, a detecta prezentările generale AI, a monitoriza cota de voce, a accesa date istorice privind clasamentul, a organiza cuvintele cheie, a crea fluxuri de raportare și a integra informațiile SEO cu restul afacerii dumneavoastră.

Pentru dezvoltatori, acesta elimină necesitatea de a exporta și muta manual datele de clasare.

Pentru agenții, acesta face posibilă automatizarea la scară largă a activităților pentru clienți.

Pentru echipele de SEO din cadrul întreprinderilor, permite ca informațiile privind clasamentul să devină parte a infrastructurii interne de analiză și date.

Faceți cunoștință cu Ranktracker

Platforma All-in-One pentru un SEO eficient

În spatele fiecărei afaceri de succes se află o campanie SEO puternică. Dar, având în vedere că există nenumărate instrumente și tehnici de optimizare din care puteți alege, poate fi greu să știți de unde să începeți. Ei bine, nu vă mai temeți, pentru că am exact ceea ce vă poate ajuta. Vă prezentăm platforma Ranktracker all-in-one pentru un SEO eficient

Am deschis în sfârșit înregistrarea la Ranktracker absolut gratuit!

Creați un cont gratuit

Sau Conectați-vă folosind acreditările dvs.

Iar cu serverul MCP al Ranktracker, aceleași date SEO de bază pot fi făcute accesibile și asistenților și agenților AI.

Creați-vă cheia API Ranktracker: https://app.ranktracker.com/account/api

Citiți documentația: https://developers.ranktracker.com/

Consultați referința API-ului REST: https://developers.ranktracker.com/rest-api/

Felix Rose-Collins

Felix Rose-Collins

Ranktracker's CEO/CMO & Co-founder

Felix Rose-Collins is the Co-founder and CEO/CMO of Ranktracker. With over 15 years of SEO experience, he has single-handedly scaled the Ranktracker site to over 500,000 monthly visits, with 390,000 of these stemming from organic searches each month.

Începeți să utilizați Ranktracker... Gratuit!

Aflați ce împiedică site-ul dvs. să se claseze.

Creați un cont gratuit

Sau Conectați-vă folosind acreditările dvs.

Different views of Ranktracker app