[ search · endpoint ]Arama API'si · Finans

Kazanç Takvimi Arama API'si

ABD kazanç takvimini yaklaşan ve yakın tarihli rapor tarihleri, EPS ve gelir tahminleri ile zamanlama (seans öncesi veya sonrası) için tek bir uç noktadan sorgulayın. Olay odaklı işlem ve AI destekli finansal araştırma için önceden biçimlendirilmiş JSON.

çağrı başına 120 kredi30 istek / dkPOST /api/search/earnings-calendar

Kazanç Takvimi Arama API'si nedir?

ABD kazanç takviminde anlamsal arama. Tahminler ve zamanlama ile sıralanmış rapor olaylarını, sonraki LLM'ler için hazır biçimde döndürür.

Temel bilgiler
Endpoint
POST /api/search/earnings-calendar
Kimlik Doğrulama
API key · x-api-key başlığı
Maliyet
çağrı başına 120 kredi
Hız limiti
30 istek / dk
Yanıt
Yapılandırılmış JSON
[ 01 · live ]

Kazanç Takvimi Aramayı canlı deneyin

API key'inizi girin ve canlı endpoint'e karşı gerçek bir sorgu çalıştırın.

auth · x-api-key

API key'iniz yok mu?

API key'lerinizi oluşturmak ve yönetmek için hesabınızda oturum açın.

5 örnek sorgu — yüklemek için tıklayın
[ 02 · integrate ]

Entegrasyon rehberi

Bir snippet kopyalayın, API anahtarınızı yerleştirin, çalıştırın. Herhangi bir HTTP istemcisinde çalışır — aşağıdaki örnekler cURL, JavaScript ve Python içindir.

spec
POST/api/search/earnings-calendar
base
https://www.apipick.com

ABD kazanç takviminde anlamsal arama. Tahminler ve zamanlama ile sıralanmış rapor olaylarını, sonraki LLM'ler için hazır biçimde döndürür.

parametreler
querystringzorunlu

Natural-language search query

max_num_resultsintegeristeğe bağlı

1–5, default 5

relevance_thresholdnumberisteğe bağlı

0.0–1.0 quality filter

country_codestringisteğe bağlı

ISO country code (e.g. US, GB)

start_datestringisteğe bağlı

ISO date YYYY-MM-DD

end_datestringisteğe bağlı

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/earnings-calendar" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Nvidia upcoming earnings date",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · yanıt
{
  "query": "Nvidia upcoming earnings date",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 120,
  "remaining_credits": 99
}
[ 03 · limits ]

Rate limit'ler

Sınırlama, API anahtarı başına ve 60 saniyelik kayan pencere ile uygulanır. Sınıra ulaştığınızda Retry-After başlığıyla birlikte temiz bir 429 alırsınız.

istek hızı

30req/min

API anahtarı başına, endpoint başına. 60 saniyelik kayan pencere.

eşzamanlılık

3concurrent

API anahtarı başına maksimum eşzamanlı işlemdeki istek sayısı.

yanıt başlıkları
X-RateLimit-LimitDakika başına izin verilen maksimum istek sayısı
X-RateLimit-RemainingMevcut penceredeki kalan istek sayısı
X-RateLimit-ResetMevcut pencere sıfırlanana kadarki saniye
Retry-AfterYeniden denemeden önce beklenecek saniye (yalnızca 429'da)
● 429 · çok fazla istek
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}
[ faq ]

Sıkça Sorulan Sorular

01

Çağrı başına neden 120 kredi?

Kazanç takvimi verisi tescilli, yapılandırılmış ve sürekli güncellenen bir veridir ve kaynak tarafından primli fiyatlandırılır; 120 kredide (çağrı başına ≈ 0,12 $) özel piyasa verisi terminallerinin oldukça altında kalır.

02

Ne döndürür?

ABD'de işlem gören şirketler için yaklaşan ve yakın tarihli çeyreklik rapor tarihleri, EPS ve gelir tahminleri ile raporlama zamanı (seans öncesi veya sonrası); sorgunuzla ilgililiğe göre sıralanır.

03

SEC aramasından farkı nedir?

SEC araması geçmiş dosyalamaları ve transkriptleri getirir; Kazanç Takvimi ileriye dönüktür — bir şirketin ne zaman rapor vermesinin beklendiğini ve piyasanın ne beklediğini söyler.

04

Tarihe göre filtreleme?

Evet. Sonuçları belirli bir raporlama aralığına daraltmak için start_date ve end_date değerlerini YYYY-MM-DD biçiminde girin.

05

OpenAI / Claude için araç şeması?

GET /api/search/earnings-calendar/tool-schema, kopyalanmaya hazır OpenAI function ve Claude tool-use tanımları döndürür.

[ explore ]

Diğer arama API'lerini keşfedin

Web Araması

LLM tool calling için tasarlanmış gerçek zamanlı anlamsal web araması. Ajan tüketimi için önceden şekillendirilmiş, sıralanmış başlıklar, URL'ler ve temiz snippet'ler döndürür. Ülke ve tarih filtreleri desteklenir.

Haber Araması

Başlıca yayın organları genelinde gerçek zamanlı haber araması. Zamana duyarlı sorgular için tarih aralığı ve ülke filtrelemesi. Sabah brifingleri, piyasa haberleri ajanları ve RAG pipeline'ları için tasarlandı.

URL İçerik Çıkarma

Çağrı başına en fazla 25 URL'den temiz, okunabilir içerik çıkarın. Reklamları, gezinmeyi ve kalıp metni ayıklar; LLM alımına hazır markdown tarzı metin döndürür. URL başına 2 kredi.

Akademik Arama

arXiv, PubMed, bioRxiv ve medRxiv genelinde hakemli makaleleri ve ön baskıları tek bir endpoint'ten arayın. Yapay zeka odaklı literatür taraması, bilimsel derlemeler üzerinde RAG ve alıntı çıkarma için tasarlandı.

Klinik Arama

Klinik çalışmaları, FDA ilaç etiketlerini ve ChEMBL biyoaktivitesini arayın. Tıbbi araştırma, ilaç yeniden konumlandırma ve yapay zeka odaklı klinik karar desteği iş akışları için tasarlandı.

SEC Beyanı Araması

SEC beyanlarını (10-K, 10-Q, 8-K), ABD kazanç çağrısı transkriptlerini ve hisse senedi istatistiklerini arayın. Yapay zeka odaklı durum tespiti, temel analiz ve finansal RAG pipeline'ları için tasarlandı.

Patent Araması

USPTO, EPO, WIPO ve başlıca ulusal ofisler genelinde küresel patent başvuruları üzerinde anlamsal arama. Bilinen teknik araştırması, IP haritalama ve yapay zeka odaklı rekabet zekası için tasarlandı.

Tahmin Piyasaları Araması

Politika, ekonomi, spor ve güncel olaylar üzerine Polymarket ve Kalshi tahmin piyasası sözleşmelerini arayın. Kalabalık tahmini alma ve olasılıkla temellendirilmiş LLM yanıtları için tasarlandı.

Birleşik Krallık Hukuk Araması

Birleşik Krallık içtihat hukuku ve birincil mevzuatı tek bir endpoint'ten anlamsal olarak arayın. Hukuki araştırma, uyumluluk incelemesi, yasal yorumlama ve yapay zeka odaklı hukuk teknolojisi iş akışları için tasarlandı.

Siber Güvenlik Araması

CISA Bilinen Sömürülen Güvenlik Açıklarını, NVD CVE kayıtlarını, EPSS sömürü puanlarını ve MITRE ATT&CK tekniklerini arayın. Yapay zeka odaklı güvenlik açığı önceliklendirmesi, tehdit istihbaratı ve güvenlik operasyonları için tasarlandı.

Piyasa Araması

Küresel ve ABD hisse senetlerini, kripto, forex, ETF'leri, yatırım fonlarını, emtiaları ve ABD piyasa hareketlilerini arayın. Yapay zeka odaklı fiyat sorgulamaları, piyasa verisi alma ve alım satım araştırması için tasarlandı.

Ekonomik Veri Araması

FRED'i, ABD Çalışma İstatistikleri Bürosu'nu, Dünya Bankası göstergelerini, IMF makro verilerini, ABD federal harcamalarını ve Alman işgücü istatistiklerini arayın. Yapay zeka odaklı makroekonomik araştırma ve analiz için tasarlandı.

Finansal Tablo Araması

ABD halka açık şirketlerinin bilançolarını, gelir tablolarını, nakit akış tablolarını, temettülerini ve içeriden işlemlerini arayın. Yapay zeka odaklı temel analiz ve durum tespiti için tasarlandı.

Kimya Araması

ChEMBL biyoaktivitesini, PubChem kimyasal yapılarını ve Open Targets hedef-hastalık ilişkilerini arayın. Yapay zeka odaklı ilaç keşfi, keminformatik ve biyomedikal araştırma için tasarlandı.

Gen ve Varyant Arama

NCBI Gene, dbSNP, ClinVar, dbVar, MedGen ve GTR'de genleri, varyantları ve klinik önemi arayın. AI destekli genomik ve varyant yorumlama için tasarlandı.

Dizi Arama

NCBI Nucleotide, Protein, Genome, Assembly, CDD ve Structure'da dizileri, assembly'leri ve protein alanlarını arayın. AI destekli biyoinformatik için tasarlandı.

Veri Kümesi Arama

NCBI SRA, GEO, BioSample, BioProject, dbGaP ve Taxonomy'de dizileme çalışmalarını, ekspresyon veri kümelerini ve organizma verilerini arayın. AI destekli omik veri keşfi için tasarlandı.

Sağlık Verisi Araması

DSÖ küresel sağlık istatistiklerini, NIH araştırma hibelerini ve openFDA ilaç advers olay raporlarını arayın. Yapay zeka odaklı halk sağlığı araştırması, hibe keşfi ve farmakovijilans için tasarlandı.

Politika Araması

Birleşik Krallık Parlamentosu tartışmalarını, yazılı soruları ve üye faaliyetlerini (Hansard) arayın. Yapay zeka odaklı sivil teknoloji araçları, yasama takibi ve politika araştırması için tasarlandı.

Wiley Finance Araması

Lisanslı Wiley finans dergilerini ve ders kitaplarını arayın. Yapay zeka odaklı akademik düzeyde finansal araştırma, literatür taraması ve yatırım analizi için tasarlandı.