Searvia Verilerinizin Üzerine Kurun
Sıraları, yapay zekâ görünürlüğünü, site sağlığını, yorumları, mağaza sayfalarını ve pazar tahminlerini kendi betiklerinizden, panolarınızdan ve uygulamalarınızdan okuyun. API, Searvia MCP sunucusuyla aynı araçları çalıştırır; plan sınırları, krediler ve hesap kapsamı aynıdır.
curl https://searvia.com/api/v1/projects \
-H "Authorization: Bearer $SEARVIA_API_KEY"Kimlik Doğrulama
Ayarlar › API ve MCP'de bir anahtar oluşturup Bearer jetonu olarak gönderin. Anahtar tek bir hesaba aittir ve yalnız o hesabın verisini görür. Aynı anahtar MCP sunucusunda da çalışır; OAuth ile bağlanan uygulamalar da API'yi kullanabilir, yalnız okuma izniyle bağlananlar hiçbir şeyi değiştiremez.
Sınırlar ve Krediler
Anahtar başına, dakikada
60 okuma, 30 değişiklik ve kredi kullanan ya da silen 10 çağrı.
Aylık
API ve MCP çağrıları tek bir aylık sınırı paylaşır: Free'de 100, Indie'de 1.000, Starter'dan itibaren sınırsız.
Krediler
"Kredi kullanır" işaretli çağrılar krediyi önizleme olmadan hemen hesap bakiyesinden düşer. Kredi yetmezse çağrı 402 döner ve hiçbir şey çalışmaz.
Her yanıtta X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıkları vardır. Sınıra ulaşınca Retry-After ile 429 alırsınız.
Yanıtlar, hatalar ve sayfalar
{
"data": [ ... ],
"meta": { "page": 1, "per_page": 50, "total": 120, "last_page": 3 }
}{
"error": {
"status": 422,
"code": "validation_failed",
"message": "Missing required field: keywords.",
"errors": { "keywords": ["The keywords field is required."] }
}
}Listeler page ve per_page (en çok 200) alır ve sonraki ile önceki sayfaları Link başlığında gönderir. Hata kodları: unauthenticated, payment_required, forbidden, not_found, validation_failed, rate_limited, unavailable ve server_error.
Uç Noktalar
Account
| GET | /account/usage | Plan, credits, quotas and this month's API and MCP calls. | Okuma |
| GET | /audit-logs | Audit log of the account (owners and admins). | Okuma |
Projects
| GET | /projects | Projects (websites and apps) of the account. | Okuma |
| GET | /projects/{project_id} | Overview of one project: rankings, visibility, reviews and open growth actions. | Okuma |
| GET | /projects/{project_id}/competitors | Tracked competitors of a project. | Okuma |
Rankings
| GET | /projects/{project_id}/keywords | Tracked keywords with current rank, 1 and 7 day change, popularity, difficulty and daily history. | Okuma |
| POST | /projects/{project_id}/keywords | Track keywords (within the plan quota; the first check runs right away). | Değişim |
| DELETE | /projects/{project_id}/keywords | Stop tracking keywords (by text or id). | Siler |
| POST | /projects/{project_id}/rankings/refresh | Check rankings now. | Değişim |
| GET | /keywords/{keyword_id}/history | Daily rank history of one keyword with competitor ranks. | Okuma |
Domains
| GET | /domain-analyses | Domain analyses of the account. | Okuma |
| POST | /domain-analyses | Analyze a domain (uses credits): traffic, keywords, top pages, page types, competitors and backlinks. | Kredi kullanır |
| GET | /domain-analyses/{analysis_id} | One domain analysis. | Okuma |
Site health
| GET | /projects/{project_id}/site-health | Latest site audit, AI discoverability, security scan and page speed of a website project. | Okuma |
| POST | /projects/{project_id}/site-audits | Start a site audit (at most once an hour). | Değişim |
| GET | /site-audits/{audit_id} | Issues and pages of one site audit. | Okuma |
| GET | /projects/{project_id}/backlinks | Backlink summary with new and lost links. | Okuma |
AI visibility
| GET | /projects/{project_id}/ai-visibility | AI visibility summary, questions and latest answers of a project. | Okuma |
| POST | /projects/{project_id}/ai-visibility/questions | Track AI questions (one per line in `prompts`). | Değişim |
| GET | /ai-visibility/questions/{prompt_id} | Timeline and answers of one AI question. | Okuma |
Apps
| GET | /projects/{project_id}/reviews | Store reviews of an app project. | Okuma |
| GET | /projects/{project_id}/metadata | Store listing of an app project per language (including the App Store keyword field when connected). | Okuma |
Market
| GET | /market/apps/{app_id} | Estimated revenue, downloads and chart history of any App Store app. | Okuma |
| GET | /market/top-earning | Top earning or fastest growing apps by country and category. | Okuma |
| GET | /market/new-winners | Recently released apps that already earn. | Okuma |
Reports
| GET | /projects/{project_id}/reports/rankings | One row per keyword and day: rank, checked depth and competitor ranks. | Okuma |
| GET | /projects/{project_id}/reports/ai-visibility | One row per AI answer: question, platform, mentioned, cited, source position and sentiment. | Okuma |
| GET | /projects/{project_id}/reports/site-health | One row per site audit: health score, AI discoverability score, errors, warnings and pages. | Okuma |
Her ucun yol, sorgu ve gövde alanları OpenAPI dosyasındadır; Postman'e, Insomnia'ya ya da bir kod üretecine aktarın.
Panolar ve Kayıtlar
Looker Studio Bağlayıcısı
Rapor uçları üzerine kurulu Looker Studio veri kaynakları: günlük sıralar, yapay zekâ görünürlüğü cevapları ve site sağlığı puanları. Her satır bir kelime ve gün, bir yapay zekâ cevabı ya da bir denetimdir.
Bağlayıcıyı KurunDenetim Kaydı
Anahtarla yapılan her değişiklik ve kredi harcaması; anahtar adı, hedef, IP ve sonuçla, panelden ve MCP'den yapılan değişikliklerin yanına kaydedilir. Sahipler ve yöneticiler bunu Ayarlar › Güvenlik'te ya da /audit-logs ucunda okur.
Denetim Kaydı Hakkında