[ search · endpoint ]API Pencarian · Keuangan

API Pencarian Kalender Earnings

Kueri kalender earnings AS untuk tanggal laporan mendatang dan terkini, estimasi EPS dan pendapatan, serta waktu before/after-market dari satu endpoint. JSON yang sudah diformat untuk trading berbasis peristiwa dan riset keuangan berbasis AI.

120 kredit / panggilan30 req / mntPOST /api/search/earnings-calendar

Apa itu API Pencarian Kalender Earnings?

Pencarian semantik atas kalender earnings AS. Mengembalikan peristiwa laporan yang diperingkat dengan estimasi dan waktu, siap untuk LLM hilir.

Fakta penting
Endpoint
POST /api/search/earnings-calendar
Autentikasi
API key · header x-api-key
Biaya
120 kredit / panggilan
Batas laju
30 req / mnt
Respons
JSON terstruktur
[ 01 · live ]

Coba Pencarian Kalender Earnings Langsung

Masukkan API key Anda dan jalankan kueri nyata terhadap endpoint yang aktif.

auth · x-api-key

Belum punya API key?

Masuk ke akun Anda untuk membuat dan mengelola API key.

5 contoh kueri — klik untuk memuat
[ 02 · integrate ]

Panduan integrasi

Salin snippet, ganti API key kamu, jalankan. Bekerja di HTTP client mana pun — contoh di bawah dalam cURL, JavaScript, dan Python.

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

Pencarian semantik atas kalender earnings AS. Mengembalikan peristiwa laporan yang diperingkat dengan estimasi dan waktu, siap untuk LLM hilir.

parameter
querystringwajib

Natural-language search query

max_num_resultsintegeropsional

1–5, default 5

relevance_thresholdnumberopsional

0.0–1.0 quality filter

country_codestringopsional

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

start_datestringopsional

ISO date YYYY-MM-DD

end_datestringopsional

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 · respons
{
  "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

Throttling berlaku per API key, jendela geser 60 detik. Jika melewati batas, kamu mendapat 429 yang rapi dengan header Retry-After.

laju request

30req/min

Per API key, per endpoint. Jendela geser 60 detik.

konkurensi

3concurrent

Maksimum request bersamaan yang sedang berjalan per API key.

header respons
X-RateLimit-LimitJumlah maksimum request yang diizinkan per menit
X-RateLimit-RemainingRequest yang tersisa di jendela saat ini
X-RateLimit-ResetDetik sampai jendela saat ini di-reset
Retry-AfterDetik yang harus ditunggu sebelum mencoba lagi (hanya pada 429)
● 429 · terlalu banyak request
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 ]

Pertanyaan yang Sering Diajukan

01

Mengapa biayanya 120 kredit per panggilan?

Data kalender earnings bersifat proprietary, terstruktur, dan terus diperbarui, diberi harga premium oleh penyedia hulu; pada 120 kredit (≈ $0,12 per panggilan) harganya tetap jauh di bawah terminal data pasar khusus.

02

Apa yang dikembalikan?

Tanggal laporan kuartalan mendatang dan terkini, estimasi EPS dan pendapatan, serta waktu pelaporan (sebelum atau setelah pasar) untuk perusahaan yang terdaftar di AS, diperingkat berdasarkan relevansi dengan kueri Anda.

03

Apa bedanya dengan pencarian SEC?

Pencarian SEC mengambil dokumen dan transkrip historis; Kalender Earnings bersifat berorientasi ke depan — memberi tahu Anda kapan sebuah perusahaan diperkirakan melapor dan apa yang diharapkan Wall Street.

04

Pemfilteran tanggal?

Ya. Kirim start_date dan end_date dalam format YYYY-MM-DD untuk membatasi hasil ke jendela pelaporan tertentu.

05

Tool schema untuk OpenAI / Claude?

GET /api/search/earnings-calendar/tool-schema mengembalikan definisi function OpenAI dan tool use Claude yang siap tempel.

[ explore ]

Jelajahi API pencarian lainnya

Pencarian Web

Pencarian web semantik real-time yang dibangun untuk tool calling LLM. Mengembalikan judul, URL, dan snippet bersih yang diperingkat serta sudah diformat untuk konsumsi agent. Mendukung filter negara dan tanggal.

Pencarian Berita

Pencarian berita real-time di media besar. Filter rentang tanggal dan negara untuk kueri yang sensitif waktu. Dibangun untuk ringkasan pagi, agent berita pasar, dan pipeline RAG.

Ekstraksi Konten URL

Ekstrak konten bersih yang mudah dibaca dari hingga 25 URL per panggilan. Menghapus iklan, navigasi, dan boilerplate; mengembalikan teks bergaya markdown yang siap untuk konsumsi LLM. 2 kredit per URL.

Pencarian Akademik

Cari makalah peer-review dan pre-print di arXiv, PubMed, bioRxiv, dan medRxiv dari satu endpoint. Dibangun untuk tinjauan pustaka berbasis AI, RAG atas korpus ilmiah, dan ekstraksi sitasi.

Pencarian Klinis

Cari uji klinis, label obat FDA, dan bioaktivitas ChEMBL. Dibangun untuk riset medis, penggunaan ulang obat, dan alur kerja dukungan keputusan klinis berbasis AI.

Pencarian Dokumen SEC

Cari dokumen SEC (10-K, 10-Q, 8-K), transkrip earnings call AS, dan statistik ekuitas. Dibangun untuk uji tuntas, analisis fundamental, dan pipeline RAG keuangan berbasis AI.

Pencarian Paten

Pencarian semantik atas dokumen paten global di USPTO, EPO, WIPO, dan kantor nasional utama. Dibangun untuk riset prior-art, pemetaan HKI, dan intelijen kompetitif berbasis AI.

Pencarian Prediction Market

Cari kontrak prediction market Polymarket dan Kalshi tentang politik, ekonomi, olahraga, dan peristiwa terkini. Dibangun untuk pengambilan prakiraan kerumunan dan jawaban LLM berbasis probabilitas.

Pencarian Hukum Inggris

Pencarian semantik atas yurisprudensi dan legislasi primer Inggris dari satu endpoint. Dibangun untuk riset hukum, tinjauan kepatuhan, interpretasi undang-undang, dan alur kerja legal-tech berbasis AI.

Pencarian Keamanan Siber

Cari CISA Known Exploited Vulnerabilities, record CVE NVD, skor eksploit EPSS, dan teknik MITRE ATT&CK. Dibangun untuk triase kerentanan, intelijen ancaman, dan operasi keamanan berbasis AI.

Pencarian Pasar

Cari ekuitas global dan AS, kripto, forex, ETF, reksa dana, komoditas, dan market mover AS. Dibangun untuk pencarian harga, pengambilan data pasar, dan riset trading berbasis AI.

Pencarian Data Ekonomi

Cari FRED, Biro Statistik Tenaga Kerja AS, indikator Bank Dunia, data makro IMF, belanja federal AS, dan statistik ketenagakerjaan Jerman. Dibangun untuk riset dan analisis makroekonomi berbasis AI.

Pencarian Laporan Keuangan

Cari neraca, laporan laba rugi, laporan arus kas, dividen, dan transaksi insider perusahaan publik AS. Dibangun untuk analisis fundamental dan uji tuntas berbasis AI.

Pencarian Kimia

Cari bioaktivitas ChEMBL, struktur kimia PubChem, dan asosiasi target-penyakit Open Targets. Dibangun untuk penemuan obat, kemoinformatika, dan riset biomedis berbasis AI.

Pencarian Gen & Varian Genomik

Cari NCBI Gene, dbSNP, ClinVar, dbVar, MedGen, dan GTR untuk gen, varian, dan signifikansi klinis. Dibangun untuk riset genomik dan interpretasi varian berbasis AI.

Pencarian Sekuens Genomik

Cari NCBI Nucleotide, Protein, Genome, Assembly, CDD, dan Structure untuk sekuens, assembly, dan domain protein. Dibangun untuk bioinformatika berbasis AI.

Pencarian Dataset Genomik

Cari NCBI SRA, GEO, BioSample, BioProject, dbGaP, dan Taxonomy untuk sequencing run, dataset ekspresi, dan data organisme. Dibangun untuk penemuan data omics berbasis AI.

Pencarian Data Kesehatan

Cari statistik kesehatan global WHO, hibah riset NIH, dan laporan efek samping obat openFDA. Dibangun untuk riset kesehatan masyarakat, penemuan hibah, dan farmakovigilans berbasis AI.

Pencarian Politik

Cari debat Parlemen Inggris, pertanyaan tertulis, dan aktivitas anggota (Hansard). Dibangun untuk alat civic-tech, pemantauan legislatif, dan riset kebijakan berbasis AI.

Pencarian Wiley Finance

Cari jurnal dan buku teks keuangan Wiley berlisensi. Dibangun untuk riset keuangan tingkat akademik, tinjauan pustaka, dan analisis investasi berbasis AI.