Zdroje pro vývojáře

Reference REST API

Integrujte hromadnou kontrolu indexace přímo do vlastních panelů, nástrojů nebo skriptů. Zautomatizujte svůj SEO workflow s naším vysokovýkonným API.

Ve zkratce

REST API IndexCheckeru vám umožní vytvářet kontrolní projekty, číst jejich stav indexace a zjišťovat zůstatek kreditů z vlastních skriptů a panelů. Každý požadavek se ověřuje vaším tajným API klíčem v těle POST, endpointy vracejí JSON, projekt přijme až 50 000 adres a 1 kredit zkontroluje 1 adresu.

Napsal Adam Piersa, zakladatel IndexCheckeru Zkontrolováno a aktualizováno

Jaké endpointy má API IndexCheckeru?

EndpointMetodaÚčel
/api/project/createPOSTVytvořit kontrolní projekt ze seznamu adres
/api/project/showPOSTZískat stav, statistiky a odkazy projektu
/api/project/show_allPOSTVypsat všechny vaše projekty
/api/project/deletePOSTTrvale smazat projekt
/api/check-balancePOSTZjistit aktuální zůstatek kreditů

Ověřování

Ověřte své požadavky tak, že do těla požadavku (parametry POST) přidáte svůj tajný API klíč.

Svůj API klíč najdete a spravujete v nastavení panelu.

Bezpečnostní upozornění: Uchovejte svůj API klíč v bezpečí. Nesdílejte jej ve veřejně přístupném kódu (např. v JS na straně klienta).


POST

Vytvořit projekt

Vytvořit nový kontrolní projekt se seznamem adres.

https://app.indexchecker.link/api/project/create
apikey povinné string

Váš tajný API klíč.

project_name povinné string

Název vašeho projektu.

urls povinné string

Seznam adres oddělených svislou čarou |.

description volitelné string
Příklad cURL POST
curl -X POST https://app.indexchecker.link/api/project/create \
  -d "apikey=YOUR_API_KEY" \
  -d "project_name=MyProject" \
  -d "urls=https://site1.com|https://site2.com"
Odpověď 200 OK
{
  "error": 0,
  "message": "project MyProject has been added in it 2 links.",
  "project_name": "MyProject",
  "procjet_id": 154,
  "project_id": 154,
  "add_links_count": 2
}

POST

Získat detaily projektu

Získat stav, statistiky a odkazy konkrétního projektu.

https://app.indexchecker.link/api/project/show
apikey povinné
project_id povinné int

ID projektu, který chcete načíst.

Odpověď 200 OK
{
  "project_name": "MyProject",
  "description": "optional description",
  "date_created": "2023-10-12 14:30:00",
  "project_id": "154",
  "urls": {
    "https://site1.com": "1",
    "https://site2.com": "-1"
  },
  "statistics": {
    "total_links": 2,
    "indexed": 1,
    "not_indexed": 0,
    "pending": 1,
    "percentage": 50
  }
}
* Stavové kódy: 1 (indexováno), 0 (neindexováno), -1 (kontrola čeká)

POST

Vypsat všechny projekty

Získat seznam všech vašich projektů.

https://app.indexchecker.link/api/project/show_all
apikey povinné
Odpověď
{
  "154": {
    "project_name": "MyProject",
    "description": "",
    "date_created": "2023-10-12 14:30:00"
  },
  "155": {
    "project_name": "Another Project",
    "description": "SEO Audit",
    "date_created": "2023-10-13 09:15:00"
  }
}

POST

Smazat projekt

Trvale odstranit projekt a všechna související data.

https://app.indexchecker.link/api/project/delete
apikey povinné
project_id povinné

ID projektu ke smazání.

Odpověď
{
  "id": "154",
  "error": 0,
  "message": "The MyProject project has been deleted"
}

POST

Zkontrolovat zůstatek

Zjistit svůj aktuální limit kreditů.

https://app.indexchecker.link/api/check-balance
apikey povinné
Odpověď 200 OK
{
  "limit": 4500,
  "error": 0
}

Často kladené otázky

Jak ověřovat požadavky API?

Přidejte svůj tajný klíč API jako parametr apikey do těla požadavku POST. Klíč najdete a změníte v nastavení panelu.

Kolik adres může mít jeden projekt přes API?

Až 50 000 adres na projekt, stejně jako v panelu. Při vytváření projektu je oddělíte svislou čarou v parametru urls.

Kolik stojí kontrola přes API?

1 kredit za zkontrolovanou adresu, včetně opětovné kontroly v druhém datovém centru. Kredity nevyprší a přístup k API je v každém balíčku, od bezplatné zkušební verze výše.

V jakém formátu API odpovídá?

V JSON. Každý endpoint vrací pole error, které je při úspěchu 0, plus data projektu - stav, statistiky a případně výsledek indexace pro jednotlivé adresy.

IndexChecker je hromadný nástroj na kontrolu indexace v Google, provozovaný společností AP2Media Sp. z o.o., firmou registrovanou v EU se sídlem v Czerwinu v Polsku (DIČ PL7582396091). Používá se v ostrém provozu na vlastních SEO projektech společnosti, včetně služby lokálního SEO drukujemy3d.pl, a za posledních 30 dní ověřil pro své zákazníky více než dva miliony adres.