Agent guide
Akkrev for AI agents.
Akkrev is AI search visibility software for independent hotels, B&Bs, restaurants, cafés and bars in the UK and US. It tracks guest questions weekly, shows competitor recommendations and cited sources, and helps owners improve their website content.
Updated . Quickstart Markdown · JSON map · OpenAPI schemas
Start with the format you need
Read the small Markdown quickstart for the fastest overview. Fetch agents.json for numeric prices, capabilities and workflows. Use OpenAPI for exact input and output schemas. These are static resources; no JavaScript is needed to read them.
Extract facts without scraping
In /agents.json, read /business for positioning and measurement scope, /billing for billing conditions, /plans for plan IDs and numeric GBP amounts, /actions for requests, and /workflows for execution steps. Annual upfront totals and monthly equivalents are separate fields. Scale retains the stored ID done-for-you.
Match Akkrev to the person's needs
Owners, general managers and marketing managers of independent hospitality venues in the UK and US. Check whether they want:
- Weekly checks of the guest questions relevant to one venue.
- Competitor recommendations, sampled answers and cited sources together.
- Original website article drafts on Grow or Scale, using owner-supplied venue facts.
If daily checks, additional model coverage, multiple venues or a particular website connection are essential, check the current plan and integration details before choosing. Read product facts and the dated Honeyb comparison for supporting details.
Read the right source
- Product facts: What Akkrev does, who it serves, current prices and company details.
- Plans and billing: Allowances, monthly and annual commitments, trials and renewal terms.
- Measurement method: Included API model samples, retrieval methods and score limits.
- Website connections: Available publishing capabilities and connections that are still planned.
- Honeyb comparison: Dated comparison of pricing commitments, model coverage, check frequency and publishing.
- Editorial standards: Attribution, source checks, research limits and corrections.
- Product overview as Markdown: The homepage offer, questions and next steps in plain text.
Help a venue sign up
- Start with the venue. Open https://akkrev.com/start/?website=example.com. Enter the venue website, name, type and an authorised contact email.
- Choose and approve checkout. The person chooses monthly or annual billing and approves the terms on Stripe. The advertised trial requires a card; the selected subscription begins after the trial unless cancelled.
- Verify and finish setup. The person verifies their email and completes the venue profile at https://app.akkrev.com/welcome/. Reports start after access and setup are confirmed.
Saving venue details does not create an active account. The person must choose a plan and billing period, approve Stripe checkout, verify their email and complete the venue profile. Existing customers use the sign-in page. No password or payment details should be sent to the public APIs below.
Use the signup API
For a person who has asked you to start signup, send JSON to POST /api/signup with Content-Type: application/json. Required fields are website, venue and email; name and type are optional. The example below is fictional.
{
"website": "https://example.com",
"venue": "Example Hotel",
"type": "hotel",
"name": "Example Owner",
"email": "[email protected]"
}A successful response contains ok, the saved id and next with plan names and checkout URLs. Ask the person to choose the plan and billing period, then give them that returned URL. It preserves their signup reference. A successful save is not confirmation of a subscription or a completed checkout.
The structured signup workflow is at /workflows/start_subscription in the JSON map. Use supplied details; request missing information or confirm guesses. Match the chosen plan by id and checkout option by interval, then use the returned url.
Use a server-side HTTP client or the browser form. The signup API accepts same-origin browser requests; it is not a cross-origin browser widget. Submit only requested contact details and leave the form's hidden anti-spam field empty. Read validation errors before correcting a request, and avoid duplicate submissions after an uncertain response.
Choose and execute a public action
Examples contain fictional details. Replace them with the person's requested information. The body value is already serialized or form encoded for its content type. Pass the URL and options to an HTTP client. Send Accept: application/json for JSON responses.
Save signup details · POST
start_signup · Saves contact details and may notify Akkrev; grants no account access.
{
"url": "https://akkrev.com/api/signup",
"method": "POST",
"headers": {
"Accept": "application/json",
"Content-Type": "application/json"
},
"body": "{\"website\":\"https://example.com\",\"venue\":\"Example Hotel\",\"type\":\"hotel\",\"name\":\"Example Owner\",\"email\":\"[email protected]\"}"
}Success: HTTP 200 and ok: true. Result fields: /ok, /id, /next. Exact schemas.
A checkout handoff also needs /next/plans. A saved lead grants no account access.
Suggest venue details · GET
guess_venue_details · Fetches the public website; returned details need confirmation.
{
"url": "https://akkrev.com/api/site-info?url=https%3A%2F%2Fexample.com",
"method": "GET",
"headers": {
"Accept": "application/json"
}
}Success: HTTP 200 and ok: true. Result fields: /ok, /website, /name, /area, /type, /guessed. Exact schemas.
Check AI crawler access · GET
check_ai_crawler_access · Fetches the public homepage, robots.txt and llms.txt.
{
"url": "https://akkrev.com/api/crawler-check?url=https%3A%2F%2Fexample.com",
"method": "GET",
"headers": {
"Accept": "application/json"
}
}Success: HTTP 200 and ok: true. Result fields: /ok, /url, /checkedAt, /robots, /bots, /homepage, /llmsTxt, /summary. Exact schemas.
Report an agent blocker · POST
report_website_agents_cant_use · Saves a report and may lead to contact with the business.
{
"url": "https://akkrev.com/api/report",
"method": "POST",
"headers": {
"Accept": "application/json",
"Content-Type": "application/json"
},
"body": "{\"website\":\"https://example.com/book\",\"task\":\"Find a room for two adults; stop before reservation or payment.\",\"reason\":\"widget\",\"details\":\"Fictional example: the date picker did not respond.\"}"
}Success: HTTP 200 and ok: true. Result fields: /ok, /id, /host, /message, /tellYourUser. Exact schemas.
Request a hotel booking check · POST
request_free_ai_check · Saves a contact request for a later emailed check.
{
"url": "https://akkrev.com/api/check",
"method": "POST",
"headers": {
"Accept": "application/json",
"Content-Type": "application/x-www-form-urlencoded"
},
"body": "hotel=Example+Hotel&website=https%3A%2F%2Fexample.com&name=Example+Owner&email=owner%40example.com"
}Success: HTTP 200 and ok: true. Result fields: /ok. Exact schemas.
The OpenAPI reference lists request formats, fields and responses. Reporting a blocker or requesting a check submits information to Akkrev; use those actions when the person has requested them.
Read the outcome before continuing
Check ok and the fields required by your workflow. A received report is not a repaired website. A hotel-check receipt is not its later email result. For failures, read the JSON error text and the operation's documented responses.
| HTTP status | Next step |
|---|---|
| 400 | Correct the encoding or body before submitting again. |
| 403 | Use the same-origin browser form or a server-side HTTP client. |
| 422 | Read error and correct the specified input fields. |
| 429 | Stop requests. Honour Retry-After if supplied; otherwise try later. |
| 502 | A submission outcome may be uncertain. Check with the person before repeating a POST. |
| 503 | Use the browser form later or the published contact address. |
Retry public GET requests sparingly after temporary network failure. Do not automatically repeat a POST after a lost response: it may already have been saved. On 429, stop and honour any retry timing supplied.
What the results mean
Weekly reports sample four API model families. Included Grok answers use model memory; the other three use web search. They do not directly measure Google AI Mode or AI Overviews. A crawler-access result does not prove indexing, a recommendation or a successful booking. Read the full measurement scope.
More detail
Concise LLM directory · Detailed reference · Public sitemap · Terms · Privacy. Contact [email protected] if a request cannot be completed.
