दस्तावेज़ और गाइड

यह कैसे काम करता है

1. आपका सर्वर पेज URL की एक सूची IndexLaunch को भेजता है, जो आपकी API key से साइन की होती है।
2. IndexLaunch हर URL की जांच करता है, हर URL के लिए एक क्रेडिट काटता है और उसे क्रॉलिंग के लिए सर्च इंजनों को भेजता है। आपको हर URL के लिए एक ID वापस मिलती है।
3. इन ID से आप जब चाहें हर URL की स्थिति देख सकते हैं।

4 चरणों में सेटअप करें

1. साइन इन करें और Settings → API Access में एक key बनाएं। यह सिर्फ़ एक बार दिखाई जाती है, इसलिए इसे तुरंत कॉपी कर लें।
2. Key को अपने सर्वर या CI पर एक सीक्रेट एनवायरनमेंट वेरिएबल के रूप में सेव करें, जैसे INDEXLAUNCH_API_KEY। इसे कभी भी ब्राउज़र कोड या सार्वजनिक रिपॉज़िटरी में न डालें।
3. जिन डोमेन के URL आप सबमिट करेंगे, उन सभी को सत्यापित करें (Settings → Domain Verification)। सर्च इंजन असत्यापित साइटों के URL अस्वीकार कर देते हैं।
4. अपने बैकएंड, किसी स्क्रिप्ट या डिप्लॉय पाइपलाइन से API को कॉल करें। नीचे दिए उदाहरण कॉपी करने के लिए तैयार हैं।

ऑथेंटिकेशन

हर रिक्वेस्ट के Authorization हेडर में अपनी key को Bearer YOUR_KEY के रूप में भेजें। सभी रिक्वेस्ट HTTPS और JSON का इस्तेमाल करती हैं।

Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

URL सबमिट करें

हर रिक्वेस्ट में 500 तक पूरे URL (https:// से शुरू होने वाले) भेजें। हर URL पर एक क्रेडिट लगता है। रिस्पॉन्स में हर URL के लिए एक ID होती है, उसी क्रम में जिसमें आपने उन्हें भेजा था।

POST https://www.indexlaunch.site/api/v1/submit
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

{ "urls": ["https://example.com/page-1", "https://example.com/page-2"] }

200 OK
{ "submitted": 2, "ids": ["j57...", "j58..."] }

किसी URL की स्थिति देखें

सबमिट रिस्पॉन्स से मिली कोई ID पास करें। आप सिर्फ़ अपने खाते से सबमिट किए गए URL ही देख सकते हैं।

GET https://www.indexlaunch.site/api/v1/urls/j57...
Authorization: Bearer il_live_xxxxxxxxxxxxxxxxxxxxxxxx

200 OK
{
  "id": "j57...",
  "url": "https://example.com/page-1",
  "status": "indexed",
  "submittedAt": 1757740800000,
  "indexedAt": 1757741100000
}

रिस्पॉन्स फ़ील्ड

id

सबमिशन ID।

url

आपके द्वारा सबमिट किया गया URL।

status

नीचे दी गई स्थिति वैल्यू में से एक।

submittedAt

सबमिट किए जाने का समय, Unix epoch से मिलीसेकंड में।

indexedAt

सर्च इंजनों द्वारा स्वीकार किए जाने का समय। तब तक यह मौजूद नहीं रहता।

स्थिति वैल्यू

pending

प्राप्त हो गया है और भेजे जाने का इंतज़ार कर रहा है। ज़्यादातर URL कुछ ही मिनटों में आगे बढ़ जाते हैं।

indexed

सर्च इंजनों ने स्वीकार कर लिया है और यह क्रॉलिंग की कतार में है। डैशबोर्ड इसे "Submitted" के रूप में दिखाता है। इससे अभी यह पक्का नहीं होता कि पेज इंडेक्स हो गया है।

failed

सर्च इंजनों ने URL स्वीकार नहीं किया, ज़्यादातर इसलिए क्योंकि डोमेन सत्यापित नहीं है। क्रेडिट अपने-आप वापस कर दिया जाता है।

refunded

URL 7 दिनों से ज़्यादा समय तक अटका रहा, इसलिए क्रेडिट अपने-आप वापस कर दिया गया।

कोड उदाहरण

curl -X POST https://www.indexlaunch.site/api/v1/submit \
  -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/new-post"]}'

const res = await fetch("https://www.indexlaunch.site/api/v1/submit", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INDEXLAUNCH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    urls: ["https://example.com/new-post", "https://example.com/pricing"],
  }),
});

const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(`Submitted ${data.submitted} URLs`, data.ids);

import os
import requests

res = requests.post(
    "https://www.indexlaunch.site/api/v1/submit",
    headers={"Authorization": f"Bearer {os.environ['INDEXLAUNCH_API_KEY']}"},
    json={"urls": ["https://example.com/new-post"]},
    timeout=30,
)
data = res.json()
if not res.ok:
    raise RuntimeError(data["error"])
print(data["submitted"], data["ids"])

# .github/workflows/indexlaunch.yml
name: Submit new pages
on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - name: Send changed URLs to IndexLaunch
        env:
          INDEXLAUNCH_API_KEY: ${{ secrets.INDEXLAUNCH_API_KEY }}
        run: |
          curl --fail-with-body -X POST https://www.indexlaunch.site/api/v1/submit \
            -H "Authorization: Bearer $INDEXLAUNCH_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"urls": ["https://example.com/new-post"]}'

एरर

एरर होने पर JSON मिलता है, जिसके error फ़ील्ड में एक संदेश होता है जिसे आप दिखा या लॉग कर सकते हैं।

400

गलत रिक्वेस्ट: बॉडी में urls सूची नहीं है, कोई URL मान्य नहीं है, 500 से ज़्यादा URL भेजे गए, पर्याप्त क्रेडिट नहीं हैं, या रिक्वेस्ट बहुत तेज़ी से आ रही हैं।

401

Key मौजूद नहीं है, गलत है या रद्द कर दी गई है।

403

खाता निलंबित है।

404

इस ID वाला कोई सबमिशन आपके खाते में नहीं है।

अच्छे तरीके

• हर डिप्लॉय पर पूरी साइट नहीं, सिर्फ़ नए या बदले हुए पेज सबमिट करें।
• हर URL के लिए अलग रिक्वेस्ट भेजने के बजाय URL को एक ही रिक्वेस्ट में बैच करें।
• अगर आपको "Too many requests" या रेट-लिमिट का संदेश मिले, तो एक मिनट रुककर फिर से कोशिश करें। आपके खाते की सटीक सीमाएं Settings → API Access में दिखाई जाती हैं।
• अगर कोई key लीक हो जाए, तो उसे सेटिंग्स में रद्द करें और नई key बनाएं। रद्द की गई key तुरंत काम करना बंद कर देती हैं।