Index Tức Thì
Bắt đầu

Lập trình viên

API index URL: một request POST để báo bất kỳ trang nào cho Google

Đăng ngày 5 août 20267 min de lectureCập nhật ngày 28 août 2026

En bref

API index URL báo một trang cho Google bằng một request POST có xác thực duy nhất. Việc xác thực dùng khóa API đặt trong header Bearer, theo định dạng ixvi_ kèm 48 ký tự thập lục phân. Một request nhận tối đa 500 URL và phản hồi ngay lập tức; việc gửi sang Google chạy nền theo lô ba URL, và Googlebot thường bắt đầu thu thập dữ liệu trong chưa đầy một phút.

Vue d’ensemble

Un point d’entrée, une méthode d’authentification, un corps de requête. La surface est volontairement réduite : chaque réglage supplémentaire est une occasion d’erreur dans une chaîne de publication automatisée.

ChampValeur
URL de basehttps://indextucthi.com
SoumissionPOST /api/indexing/submit
HistoriqueGET /api/indexing/history
Solde de créditsGET /api/user/credits
En-tête d’authentificationAuthorization: Bearer ixvi_<48 caractères hexadécimaux>
Content-Typeapplication/json
URL par requête1 à 500
Rétention de l’historique48 heures

Il n’y a pas de quota journalier au sens strict : votre débit est borné par votre solde de crédits, acheté une fois, sans reconduction ni date d’expiration.

Authentification

Les endpoints authentifiés acceptent soit une session par cookie, soit une clé d’API en en-tête Bearer. Pour un usage programmatique, utilisez toujours la clé.

  1. Connectez-vous au tableau de bord.
  2. Ouvrez Profil → Accès API.
  3. Cliquez sur Générer une clé. Elle n’est affichée qu’une fois — copiez-la immédiatement.
  4. Rangez-la dans votre gestionnaire de secrets : variable d’environnement, coffre, ou équivalent. Jamais dans le dépôt de code.

Soumettre des URL (cURL)

bash
curl -X POST https://indextucthi.com/api/indexing/submit \
  -H "Authorization: Bearer ixvi_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://votresite.fr/blog/article-1",
      "https://votresite.fr/blog/article-2"
    ]
  }'

La réponse revient immédiatement, avant même que les URL soient parties vers Google :

json
{
  "success": true,
  "submitted": 2,
  "failed": 0,
  "creditsUsed": 2,
  "remainingCredits": 78,
  "results": [
    { "url": "https://votresite.fr/blog/article-1", "status": "submitted" },
    { "url": "https://votresite.fr/blog/article-2", "status": "submitted" }
  ]
}

Soumettre des URL (Node.js)

javascript
async function envoyerUrls(urls) {
  const res = await fetch(
    "https://indextucthi.com/api/indexing/submit",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.IXVI_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ urls }),
    }
  );
  if (!res.ok) throw new Error(`Échec de la soumission : ${res.status}`);
  return res.json();
}

const resultat = await envoyerUrls([
  "https://votresite.fr/blog/article-1",
  "https://votresite.fr/blog/article-2",
]);
console.log("Acceptées :", resultat.submitted, "— crédits restants :", resultat.remainingCredits);

Soumettre des URL (Python)

python
import os
import requests

def envoyer_urls(urls):
    res = requests.post(
        "https://indextucthi.com/api/indexing/submit",
        headers={
            "Authorization": f"Bearer {os.environ['IXVI_API_KEY']}",
            "Content-Type": "application/json",
        },
        json={"urls": urls},
        timeout=10,
    )
    res.raise_for_status()
    return res.json()

resultat = envoyer_urls([
    "https://votresite.fr/blog/article-1",
    "https://votresite.fr/blog/article-2",
])
print("Acceptées :", resultat["submitted"], "— crédits restants :", resultat["remainingCredits"])

Consulter l’historique

Les enregistrements sont conservés 48 heures. L’endpoint d’historique est paginé et renvoie l’état de chaque adresse :

bash
curl "https://indextucthi.com/api/indexing/history?page=1&limit=20" \
  -H "Authorization: Bearer ixvi_VOTRE_CLE"

Chaque enregistrement contient l’URL, son état (submitted, indexed ou failed), le moteur visé, les crédits consommés, l’horodatage, et le motif d’échec normalisé le cas échéant.

Gestion des erreurs

CodeCauseAction
400JSON malformé, ou aucune URL valide dans le corpsValidez l’entrée avant l’envoi
401Clé d’API absente ou invalideVérifiez l’en-tête Authorization
402Crédits insuffisantsRechargez le compte
413Plus de 500 URL dans une requêteDécoupez la liste en tranches de 500
429Trop de requêtesRalentissez et réessayez avec un intervalle croissant
503Service d’indexation momentanément indisponibleRéessayez : les URL sont remises en file de notre côté

Bonnes pratiques

Exemple : brancher l’API sur un CMS

javascript
// Dans le hook « article publié » de votre CMS
async function surPublication(article) {
  await envoyerUrls([
    `https://votresite.fr/${article.slug}`,
  ]);
}

// Ou avec les URL connexes, lors d’une refonte de contenu
async function surModificationMajeure(article) {
  await envoyerUrls([
    `https://votresite.fr/${article.slug}`,
    `https://votresite.fr/categorie/${article.categorie}`,
    "https://votresite.fr/sitemap.xml",
  ]);
}

Par où commencer

Créez un compte, générez une clé depuis le tableau de bord, et insérez la requête POST dans votre chaîne de publication. L’offre d’entrée, à 5 $ pour 80 crédits, suffit largement à valider l’intégration de bout en bout avant de passer à un volume supérieur.

Câu hỏi thường gặp

Khóa API có phải là mật khẩu của tôi không?

Không. Đó là một thông tin đăng nhập riêng, tạo từ bảng điều khiển, dành cho việc gọi bằng code, và tạo lại được độc lập với mật khẩu tài khoản.

Có cần gói trả phí mới dùng được API không?

Toàn quyền truy cập API có trong mọi gói, bắt đầu từ 5 $ cho 80 tín dụng. Không có gói nào dành riêng cho API. Thanh toán thực hiện bằng tiền mã hóa qua Cryptomus hoặc NOWPayments tùy theo số tiền; thẻ và PayPal được hỗ trợ trên trang tiếng Anh instanturlindexer.com, nơi tín dụng gắn với tài khoản tạo ở đó.

Chuyện gì xảy ra nếu request của tôi chứa URL không hợp lệ?

Chúng bị loại ngay ở bước kiểm tra, không nằm trong lô và không bị tính phí. Các địa chỉ hợp lệ trong cùng lần gửi vẫn được xử lý bình thường. Phản hồi trả về cả hai con số: submitted và failed.

Có webhook báo đã index xong không?

Hiện thì chưa. Một HTTP callback cho các sự kiện kết thúc xử lý đang nằm trong lộ trình. Trong lúc chờ, hãy gọi endpoint lịch sử hoặc theo dõi trạng thái trong bảng điều khiển. Lưu ý là một webhook như vậy sẽ báo việc gửi URL đã xong, chứ không báo Google đã xác nhận lập chỉ mục.

Để Google quét trang của bạn ngay hôm nay

Tối đa 500 URL mỗi lần gửi, trạng thái thật cho từng dòng, API có trong mọi gói. Chúng tôi đảm bảo việc gửi URL và việc Google thu thập dữ liệu; việc index vẫn là quyết định của Google.

Tạo tài khoảnXem bảng giá

Đọc tiếp

Bắt đầu

Cách index website lên Google trong chưa đầy một phút

6 phút đọc

Chiến lược SEO

Gửi URL lên Google hàng loạt: 500 địa chỉ chỉ trong một lần

7 phút đọc

Xử lý sự cố

Google không index bài viết: 9 nguyên nhân và cách khắc phục

8 phút đọc