POST AI agent ready /v1/social-preview/extract

API Pratinjau Sosial - Ekstrak Grafik Terbuka & Meta Tag Kartu Twitter

Mengambil URL dan mengekstrak tag Open Graph (og:title, og:description, og:image, og:type, og:site_name), tag Twitter Card (twitter:card, twitter:title, twitter:image, twitter:site, twitter:creator), dan metadata HTML umum (judul, deskripsi, kanonik, favicon). Mengembalikan peringatan untuk tag yang hilang atau salah format.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/social-preview/extract \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

When to use this API

Tautkan kartu pratinjau di platform obrolan dan CMS

Saat pengguna menempelkan URL ke aplikasi Anda, panggil titik akhir ini untuk mengambil data Open Graph dan merender kartu pratinjau tautan kaya dengan judul, deskripsi, dan gambar. Berfungsi untuk pembukaan tautan gaya Slack.

Audit SEO untuk berbagi sosial

Pindai halaman Anda untuk memverifikasi bahwa tag Open Graph dan Twitter Card ada dan diformat dengan benar. Temukan og:tag gambar atau deskripsi yang terpotong sebelum berbagi kampanye ditayangkan.

Pengayaan sistem manajemen konten

Saat editor menambahkan tautan eksternal ke artikel, otomatis mengisi judul tautan, deskripsi, dan gambar mini dari metadata yang diekstraksi. Menghemat entri data manual dan menjaga konsistensi kartu pratinjau.

Frequently asked questions

Apa yang terjadi jika halaman tersebut tidak memiliki tag Open Graph?

Bagian og mengembalikan nilai null untuk tag yang hilang. Bagian umum kembali ke tag HTML <title> dan <meta name="description">. Peringatan ditambahkan untuk setiap tag OG yang hilang.

Apakah ini mengikuti pengalihan?

Ya. Titik akhir menindaklanjuti hingga 5 pengalihan dan mengekstrak metadata dari URL tujuan akhir.

Bisakah saya mengekstrak metadata dari halaman yang memerlukan JavaScript?

Tidak. Titik akhir mengambil respons HTML mentah. Aplikasi satu halaman yang memasukkan tag OG melalui JavaScript akan mengembalikan metadata yang tidak lengkap. Halaman yang dirender di server berfungsi dengan benar.

Apa saja peringatan umum yang diberikan?

Peringatan mencakup og:title yang hilang, og:image yang hilang, og:deskripsi yang panjangnya lebih dari 200 karakter, tag Kartu Twitter yang hilang, dan URL og:image yang mengembalikan tipe konten non-gambar.

Apakah og:URL gambar divalidasi?

Titik akhir mengembalikan og:URL gambar apa adanya dari HTML. Itu tidak mengambil gambar untuk memverifikasi keberadaannya atau memeriksa dimensinya. Gunakan permintaan HEAD terpisah untuk memvalidasi URL gambar.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.