API

A crawler automatically updates the list of websites. Only registered partners at GetKirby.com can apply to me for an API key to submit new websites and manage their listed websites.

by Bruno Meilick,
Read time 1 minute

Using the API for Partners

If you are a registered partner at GetKirby.com, you can contact me via Discord or e-mail, and I will provide you with an API key.

Known Limitation: You can not link websites on this index to your user account. Please send me a newline-separated list of your URLs, and I will re-link your user account to them.

Caches are flushed every full hour, so it might take a while for your pages to appear as listed/updated/deleted.

The examples use CURL, but you can use any tool to send the queries.

List all your websites

curl --request GET "https://audit.bnomei.com/reports?expand=1" --header "X-API-KEY: {your_api_key}"
curl --request POST "https://audit.bnomei.com/reports?url=https://example.com" --header "X-API-KEY: {your_api_key}"

List details about one of your websites

curl --request GET "https://audit.bnomei.com/reports/{id_of_website}?expand=1" --header "X-API-KEY: {your_api_key}"

Trigger the meta-data refresh for one of your websites

curl --request PATCH "https://audit.bnomei.com/reports/{id_of_website}" --header "X-API-KEY: {your_api_key}"

Upload a custom preview screenshot for a website (JPG, <200kb)

curl -F "preview=@path/to/preview.jpg" https://audit.bnomei.com/reports/{id_of_website} --header "X-API-KEY: {your_api_key}"

Delete a website

curl --request DELETE https://audit.bnomei.com/reports/{id_of_website} --header "X-API-KEY: {your_api_key}"