Skip to content

Docs / All tools / Loop I: Distribution

inbound.page.audit

Audit a published page for performance and accessibility with Lighthouse.

2 credits. Per audit.

Example prompt

Send this to your AI app when Heelo is connected:

Run Lighthouse three times on my early-access landing page

Input fields

FieldTypeDescription
page_urlRequiredstringURL of a page you published with inbound.page.publish
runsintegerHow many Lighthouse runs (1-5)
presetstringdesktop | mobile (mobile is Lighthouse's default form factor)

Output fields

The fields in data when status is success.

FieldType
page_urlstring
presetstring
lighthouse_versionstring
runsarray of object
median_performancenumber
median_accessibilitynumber
both_at_least_90boolean
answerstring

Code

The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/inbound.page.audit/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "page_url": "https://example.com",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())