API dokümantasyonu

API adresi: https://2index.ninja/api/v1/

API'ye istekte bulunmak için Yetkilendirme başlığında Taşıyıcı erişim belirtecini geçirmeniz gerekir.

 Erişim belirteci uygun olandan alınabilir curl https://2index.ninja/api/v1/account -H "Authorization: Bearer API_TOKEN"

Kullanıcı hesabındaki bölüm .

Her isteğe verilen yanıt, isteğin başarısını belirleyen bir success parametresi içerir. errors parametresi ise hata mesajlarını içerir.

Bazı durumlarda, 403 hatası döndürülürse, kullanıcı aracısını belirtmeniz gerekir, örneğin:

 İstekler barındırma sağlayıcısı tarafından sınırlandırılabilir, bu durumda proxy kullanmanızı öneririz. curl https://2index.ninja/api/v1/account -H "Authorization: Bearer API_TOKEN" -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36"

Bir hesapla çalışma yöntemleri

Hesap ayrıntılarını al

account adresine bir GET isteği gerçekleştirmeniz gerekiyor

 Yanıt JSON formatında veri içerecektir: GET https://2index.ninja/api/v1/account

 { "success": true, "account": { "email": "[email protected]", "tariff": "White Ninja", "balance": 100.0, "available_projects": 1, "available_links": 100, "available_indexation_check_links": 500, "link_sending_speed": 100, "tariff_available": true, "tariff_expiring_date": "2025-01-16T14:26:11.000000Z", "email_verified": false, "link_cost": "$0.00056" } } Projelerle çalışma yöntemleri { "success": true, "account": { "email": "[email protected]", "tariff": "White Ninja", "balance": 100.0, "available_projects": 1, "available_links": 100, "available_indexation_check_links": 500, "link_sending_speed": 100, "tariff_available": true, "tariff_expiring_date": "2025-01-16T14:26:11.000000Z", "email_verified": false, "link_cost": "$0.00056" } } 

Projelerin bir listesini alın

project adresine bir GET isteği gerçekleştirmeniz gerekiyor

 Yanıt JSON formatında veri içerecektir: GET https://2index.ninja/api/v1/project

 { "success": true, "projects": [ { "id": 1, "name": "Project name", "type": "indexing", "website": "https://domain.com/", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_type": "internal", "google_account_access_granted": 0, "links_total": 500, "links_sending_speed": 400, "links_sent_google": 100, "links_sent_yandex": 40, "links_sent_bing": 100, "in_queue": 360, "sent_links": 100, "indexed": 30, "not_indexed": 0, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_sent_url": "DOWNLOAD_SENT_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL" }, { "id": "2", "name": "Project 2 name", "type": "indexing_check", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_total": 200, "links_checking_speed": 100, "in_queue": 100, "checked": 100, "indexed": 70, "not_indexed": 30, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL", "download_all_url": "DOWNLOAD_ALL_URL", "download_checked_url": "DOWNLOAD_CHECKED_URL", } ... ] } Proje verilerini al { "success": true, "projects": [ { "id": 1, "name": "Project name", "type": "indexing", "website": "https://domain.com/", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_type": "internal", "google_account_access_granted": 0, "links_total": 500, "links_sending_speed": 400, "links_sent_google": 100, "links_sent_yandex": 40, "links_sent_bing": 100, "in_queue": 360, "sent_links": 100, "indexed": 30, "not_indexed": 0, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_sent_url": "DOWNLOAD_SENT_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL" }, { "id": "2", "name": "Project 2 name", "type": "indexing_check", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_total": 200, "links_checking_speed": 100, "in_queue": 100, "checked": 100, "indexed": 70, "not_indexed": 30, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL", "download_all_url": "DOWNLOAD_ALL_URL", "download_checked_url": "DOWNLOAD_CHECKED_URL", } ... ] }

project/{project_id} adresine bir GET isteği yapmanız gerekiyor

 Yanıt JSON formatında veri içerecektir: GET https://2index.ninja/api/v1/project/1

• Dizinleme projesi için:

 { "success": true, "project": { "id": 1, "name": "Project name", "type": "indexing", "website": "https://domain.com/", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_type": "internal", "google_account_access_granted": 0, "links_total": 500, "links_sending_speed": 400, "links_sent_google": 100, "links_sent_yandex": 40, "links_sent_bing": 100, "in_queue": 360, "sent_links": 100, "indexed": 30, "not_indexed": 0, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_sent_url": "DOWNLOAD_SENT_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL" } } Endeksleme doğrulama projesi için: { "success": true, "project": { "id": 1, "name": "Project name", "type": "indexing", "website": "https://domain.com/", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_type": "internal", "google_account_access_granted": 0, "links_total": 500, "links_sending_speed": 400, "links_sent_google": 100, "links_sent_yandex": 40, "links_sent_bing": 100, "in_queue": 360, "sent_links": 100, "indexed": 30, "not_indexed": 0, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_sent_url": "DOWNLOAD_SENT_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL" } }

 { "success": true, "project": { "id": "2", "name": "Project 2 name", "type": "indexing_check", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_total": 200, "links_checking_speed": 100, "in_queue": 100, "checked": 100, "indexed": 70, "not_indexed": 30, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL", "download_all_url": "DOWNLOAD_ALL_URL", "download_checked_url": "DOWNLOAD_CHECKED_URL" } } Bir proje oluşturun { "success": true, "project": { "id": "2", "name": "Project 2 name", "type": "indexing_check", "status": "in progress", "created_at": "2024-03-01 14:34:56", "links_total": 200, "links_checking_speed": 100, "in_queue": 100, "checked": 100, "indexed": 70, "not_indexed": 30, "download_queue_url": "DOWNLOAD_QUEUE_URL", "download_indexed_url": "DOWNLOAD_INDEXED_URL", "download_unindexed_url": "DOWNLOAD_UNINDEXED_URL", "download_all_url": "DOWNLOAD_ALL_URL", "download_checked_url": "DOWNLOAD_CHECKED_URL" } }

project adresine bir POST isteği gerçekleştirmeniz gerekiyor

 İstek parametreleri: POST https://2index.ninja/api/v1/project

** Herhangi bir tipte proje oluştururken indexing_speed veya checking_speed parametrelerinden birini kullanabilirsiniz; bunlar birbirinin takma adıdır, ancak ikisi de geçirilirse indexing_speed kullanılır.

Yanıt JSON formatında veri içerecektir:

 { "success": true, "message": "The project has been successfully created" } Bağlantı indeksleme projesi oluşturmaya bir örnek: { "success": true, "message": "The project has been successfully created" }

POST https://2index.ninja/api/v1/project

 name: Project 1 website: https://website.com for_external_links: 1 indexing_speed: 100 Bağlantı indeksleme kontrol projesi oluşturmaya bir örnek: name: Project 1 website: https://website.com for_external_links: 1 indexing_speed: 100

POST https://2index.ninja/api/v1/project

 name: Project 2 checking_speed: 100 Dizinleme kuyruğunu temizle name: Project 2 checking_speed: 100

project/{project_id}/clear_queue adresine bir POST isteği göndermeniz gerekiyor

 Yanıt JSON formatında veri içerecektir: POST https://2index.ninja/api/v1/project/1/clear_queue

 { "success": true, "message": "The indexing queue has been cleared successfully. X links have been removed" } Veya buna karşılık gelen hata mesajı döndürülecektir: { "success": true, "message": "The indexing queue has been cleared successfully. X links have been removed" }

 { "success": false, "errors": ["Project not found"] } Bağlantılarla çalışma yöntemleri { "success": false, "errors": ["Project not found"] } 

Bağlantıları ekle

link/add adresine bir POST isteği yapmanız gerekiyor

 İstek parametreleri: POST https://2index.ninja/api/v1/link/add

Yanıt JSON formatında veri içerecektir:

 { "success": true, "message": "Links have been successfully added to the project" } Listede geçersiz bağlantılar varsa, bağlantılar eklenmeyecek ve yanıt olarak şu hata mesajı alınacaktır: { "success": true, "message": "Links have been successfully added to the project" }

 { "success": false, "errors": ["You sent invalid links"], "invalid_links": ["http://wrong.link"] } Projeler için { "success": false, "errors": ["You sent invalid links"], "invalid_links": ["http://wrong.link"] }

Bağlantı dizinleme kontrolleri, dizinlemeyle aynı şekilde eklenir. google_access_granted isteğe bağlıdır ve yok sayılır. Arama motorlarının belirtilmesi gerekir, ancak şu anda yalnızca Google aramaları kullanılabilir.

Proje adına göre bağlantı ekleyin

link/add_simple bir POST isteği göndermeniz gerekiyor. Belirtilen isimde bir proje yoksa, maksimum yükleme hızında otomatik olarak oluşturulacaktır.

 İstek parametreleri: POST https://2index.ninja/api/v1/link/add_simple

Dizin doğrulama projeleri için bağlantılar, dizinlemeyle aynı şekilde eklenir. google_access_granted isteğe bağlıdır ve yok sayılır. Arama motorları belirtilmelidir, ancak doğrulama şu anda yalnızca Google için kullanılabilir.

Örnek istek:

 { "project_name": "My Website", "links": ["https://example.com/page1", "https://example.com/page2"], "google": true, "yandex": false, "bing": true, "google_access_granted": false } Başarılı olursa yanıt: { "project_name": "My Website", "links": ["https://example.com/page1", "https://example.com/page2"], "google": true, "yandex": false, "bing": true, "google_access_granted": false }

 { "success": true, "message": "Links have been successfully added to the project", "project_name": "My Website", "project_id": 12345 } Olası hatalar: { "success": true, "message": "Links have been successfully added to the project", "project_name": "My Website", "project_id": 12345 }

• Listede hatalı bağlantılar varsa:

 { "success": false, "errors": ["You sent invalid links"], "invalid_links": ["http://wrong.link"] } Bir proje oluşturulurken bir hata oluştuysa: { "success": false, "errors": ["You sent invalid links"], "invalid_links": ["http://wrong.link"] }

 { "success": false, "errors": ["Failed to create the project"] } Bağlantı durumunu kontrol edin { "success": false, "errors": ["Failed to create the project"] } 

Adrese bir POST isteği gerçekleştirin   /api/v1/link/status

 İstek parametreleri: POST https://2index.ninja/api/v1/link/status 

• İstek başarılı olursa, yanıt olarak bir json nesnesi alınacaktır:

 { "success" : true , "link" : { "id" : 34368960 , "url" : "https://2index.ninja/" , "google" : "Sent" , "yandex" : "Sent" , "bing" : "Sent" , "is_external" : 1 , "google_sent" : "2025-08-24 20:10:02" , "yandex_sent" : "2025-08-24 20:45:02" , "bing_sent" : "2025-08-24 20:05:05" , "google_indexed" : 1 , "google_indexing_check_date" : "2025-08-29" } } Nerede: { "success" : true , "link" : { "id" : 34368960 , "url" : "https://2index.ninja/" , "google" : "Sent" , "yandex" : "Sent" , "bing" : "Sent" , "is_external" : 1 , "google_sent" : "2025-08-24 20:10:02" , "yandex_sent" : "2025-08-24 20:45:02" , "bing_sent" : "2025-08-24 20:05:05" , "google_indexed" : 1 , "google_indexing_check_date" : "2025-08-29" } } 

* Olası durumlar:

• Bir hata oluşursa, hata mesajını içeren bir JSON nesnesi döndürülür. Hata örnekleri:

 { "success" : false , "errors" : { "link" : [ "The link field is required." ] } } { "success" : false , "errors" : [ "Project not found" ] } { "success" : false , "errors" : { "link" : [ "The link field is required." ] } } 

 { "success" : false , "errors" : [ "Project not found" ] } { "success" : false , "errors" : [ "URL not found" ] } { "success" : false , "errors" : [ "Project not found" ] } 

 { "success" : false , "errors" : [ "URL not found" ] } Bağlantı durumunu bağlantı kimliğine göre de alabilirsiniz { "success" : false , "errors" : [ "URL not found" ] } 

Bunu yapmak için adrese bir GET isteği gerçekleştirin   /api/v1/link/status/ID

 İsteğe verilecek cevap önceki versiyondaki ile aynı olacaktır. GET https://2index.ninja/api/v1/link/status/ID

Referans kaynaklarıyla çalışma

Bağlantı kaynakları tüm proje türleri için mevcuttur ve aynı şekilde işlenir. Dizin kontrol projeleri için yalnızca Google kullanılabilir.

Site haritası ekleme

/api/v1/sitemap/add bir POST isteği yapın

 İstek parametreleri: POST https://2index.ninja/api/v1/sitemap/add

Olası hatalar:

Örnek cevaplar:

Site haritası başarıyla eklendi:

 { "success": true, "message": "Карта сайта успешно добавлена, мы скачаем её как можно скорее и отправим уведомление по электронной почте после завершения." } Doğrulama hatası: { "success": true, "message": "Карта сайта успешно добавлена, мы скачаем её как можно скорее и отправим уведомление по электронной почте после завершения." }

 { "errors": ["sitemap":["The sitemap field is required."]] } Proje bulunamadı: { "errors": ["sitemap":["The sitemap field is required."]] }

 { "errors": ["Project not found"] } Site haritası izleme durumu güncellemesi { "errors": ["Project not found"] } 

/api/v1/sitemap/update_watch bir POST isteği yapın

 İstek parametreleri: POST https://2index.ninja/api/v1/sitemap/update_watch

Olası hatalar:

Örnek cevaplar:

İzleme durumunun başarılı bir şekilde güncellenmesi:

 { "success": true } Bağlantı kaynağı bulunamadı: { "success": true }

 { "errors": ["Link source not found"] } Bir bağlantı kaynağını kaldırma { "errors": ["Link source not found"] }

/api/v1/sitemap/delete bir POST isteği yapın

 İstek parametreleri: POST https://2index.ninja/api/v1/sitemap/delete

Olası hatalar:

Örnek cevaplar:

Bağlantı kaynağı başarıyla kaldırıldı:

 { "success": true, "message": "Источник ссылок успешно удален" } Proje bulunamadı: { "success": true, "message": "Источник ссылок успешно удален" }

 { "errors": ["Project not found"] } Referans kaynaklarının listesi { "errors": ["Project not found"] }

Eklenen bağlantı kaynaklarının listesini almak için https://2index.ninja/api/v1/link_sources adresine bir POST isteği göndermeniz gerekir.

İstekte project_id iletin

Sonuç olarak aşağıdaki veri seti döndürülecektir:

 [ { "id": 1247, "project_id": 3540, "name": "urls.txt", "type": "text file", "created_at": "2025-01-17T15:51:43.000000Z", "processing_date": "2025-01-17T15:51:48.000000Z", "has_error": false, "error_message": "", "status": "success", "is_pending": false, "is_success": true, "total_links": 29585, "added_links": 29582, "invalid_links": 3, "watch": 0, "google_access_granted": 0, "is_external_links": 1, "search_engines": { "google": "1" } }, { "id": 22, "project_id": 3540, "name": "https://2index.ninja/sitemap.xml", "type": "sitemap", "created_at": "2025-07-03T14:24:23.000000Z", "processing_date":, "has_error":, "error_message":, "status": "pending", "is_pending": 1, "is_success":, "total_links": 0, "added_links": 0, "invalid_links": 0, "watch": 1, "google_access_granted": 0, "is_external_links": 1, "search_engines": { "google": 1 } } ] Nerede [ { "id": 1247, "project_id": 3540, "name": "urls.txt", "type": "text file", "created_at": "2025-01-17T15:51:43.000000Z", "processing_date": "2025-01-17T15:51:48.000000Z", "has_error": false, "error_message": "", "status": "success", "is_pending": false, "is_success": true, "total_links": 29585, "added_links": 29582, "invalid_links": 3, "watch": 0, "google_access_granted": 0, "is_external_links": 1, "search_engines": { "google": "1" } }, { "id": 22, "project_id": 3540, "name": "https://2index.ninja/sitemap.xml", "type": "sitemap", "created_at": "2025-07-03T14:24:23.000000Z", "processing_date":, "has_error":, "error_message":, "status": "pending", "is_pending": 1, "is_success":, "total_links": 0, "added_links": 0, "invalid_links": 0, "watch": 1, "google_access_granted": 0, "is_external_links": 1, "search_engines": { "google": 1 } } ]

id - bağlantı kaynağının kimliği
project_id - proje kimliği
name - ekli dosyanın adı veya site haritası adresi
type - dosya kaynak türü (metin dosyası veya site haritası) - şunlar olabilir:
sitemap ,
text file
created_at - oluşturma tarihi
processing_date - işleme tarihi
has_error - bir işlem hatası oluştu
error_message - hata mesajı
status - durum - şu şekilde olabilir:
pending (işlenmeyi bekleyen),
error (işleme hatası),
success
is_pending - şu anda işleniyor
is_success - başarılı işlem
total_links - bulunan toplam bağlantı sayısı
added_links - eklenen bağlantılar
invalid_links - geçersiz bağlantılar
watch - site haritası izleme durumu
google_access_granted - Bir Google hesabına erişim izni verilip verilmediği
is_external_links - harici bağlantılar
search_engines - bağlı arama motorları

PHP'de örnek uygulama