# TendorAI — Full Documentation for AI Systems

> The UK's AI Visibility Platform for professional services. Structured data
> profiles for solicitors, accountants, mortgage advisers, estate agents, and
> office equipment suppliers — so AI recommends them by name.

TendorAI is the structured data layer between UK service providers and AI.
When someone asks an AI assistant for a supplier recommendation, TendorAI
provides the verified, structured data AI needs to give a specific answer.

## What TendorAI Does

TendorAI helps UK businesses become visible to AI recommendation engines
like ChatGPT, Claude, Perplexity, and Google AI. We provide:

- Structured data profiles with Schema.org markup optimised for AI crawlers
- Free AI Visibility (AEO) reports scoring 0-100
- AI Visibility (AEO) audits checking website readiness for AI discovery
- Self-service alternative to AI Visibility (AEO) agencies (£299/month vs £1,500-8,000/month)
- Directory listings that AI platforms can read and recommend from

## Business Verticals

### Solicitors (10,000+ firms)
SRA-registered solicitor firms across England and Wales.
Practice areas: Conveyancing, Family Law, Criminal Law, Commercial Law,
Employment Law, Wills & Probate, Immigration, Personal Injury.
Schema type: LegalService

### Accountants
ICAEW-registered accountancy practices across England and Wales.
Services: Tax Advisory, Audit & Assurance, Bookkeeping, Payroll,
Corporate Finance, Business Advisory, VAT, Financial Planning.
Schema type: AccountingService

### Mortgage Advisers
FCA-regulated mortgage advisory firms across England and Wales.
Services: Residential Mortgages, Buy-to-Let, Remortgage, First-Time Buyer,
Equity Release, Commercial Mortgages, Protection Insurance.
Schema type: FinancialService

### Estate Agents
Estate agencies across England and Wales.
Services: Sales, Lettings, Property Management, Block Management,
Auctions, Commercial Property, Inventory.
Schema type: RealEstateAgent

### Office Equipment (1,044 dealers)
Photocopier dealers, telecoms providers, CCTV installers, IT support companies.
Categories: Photocopiers & Managed Print, Telecoms & VoIP, CCTV & Security,
IT Services & Support.
Schema type: LocalBusiness

## Coverage Areas

### All of England and Wales
Major cities: London, Birmingham, Manchester, Bristol, Cardiff, Leeds,
Liverpool, Sheffield, Newcastle, Nottingham, Edinburgh, Glasgow, Swansea,
Newport, Bath, Exeter, Gloucester, Cheltenham, Plymouth, Swindon, Oxford,
Cambridge, Southampton, Portsmouth, Brighton, Reading, Leicester, Coventry,
Wolverhampton, Derby, Stoke-on-Trent, York, Preston, Warrington, Chester,
Worcester, Hereford, Guildford, Slough, Hull, Aberdeen, Dundee, Belfast

## API Reference

### GET /api/public/vendors

List and search verified suppliers.

**Parameters:**
| Parameter | Type   | Required | Description |
|-----------|--------|----------|-------------|
| category  | string | No       | Filter by service: Photocopiers, Telecoms, CCTV, IT, Security, Software |
| location  | string | No       | Filter by city name or region |
| postcode  | string | No       | UK postcode for distance-based results |
| distance  | number | No       | Maximum distance in km (default: 50, only with postcode) |
| brand     | string | No       | Filter by brand or accreditation |
| page      | number | No       | Page number (default: 1) |
| limit     | number | No       | Results per page (default: 20, max: 100) |

**Example Request:**
```
GET https://www.tendorai.com/api/public/vendors?category=Photocopiers&location=Cardiff&limit=10
```

**Example Response:**
```json
{
  "success": true,
  "data": [
    {
      "id": "abc123",
      "company": "Example Copier Co",
      "services": ["Photocopiers"],
      "location": {
        "city": "Cardiff",
        "region": "South Wales",
        "coverage": ["Cardiff", "Newport", "Bridgend"]
      },
      "performance": {
        "rating": 4.5,
        "reviewCount": 12
      },
      "businessProfile": {
        "description": "Established photocopier dealer serving South Wales since 2005.",
        "accreditations": ["Konica Minolta Authorised Dealer"],
        "yearsInBusiness": 19
      },
      "brands": ["Konica Minolta", "Ricoh"],
      "tier": "verified",
      "productCount": 8
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 25,
    "pages": 3
  }
}
```

### POST /api/ai-query

Intelligent vendor matching using natural language.

**Request Body:**
```json
{
  "query": "I need a conveyancing solicitor in Bristol",
  "category": "Solicitors",
  "location": "Bristol"
}
```

**All Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| query | string | Yes | Natural language description of needs |
| location | string | No | UK postcode or city name |
| category | string | No | Solicitors, Photocopiers, Telecoms, CCTV, IT, Security, Software |

### Vendor Profile URLs

Individual vendor profiles:
```
https://www.tendorai.com/suppliers/vendor/{slug}
https://www.tendorai.com/suppliers/profile/{vendorId}
```

### Category + Location Pages

Browse suppliers by category and location:
```
https://www.tendorai.com/suppliers/{category}
https://www.tendorai.com/suppliers/{category}/{location}
```

Solicitor categories: conveyancing, family-law, criminal-law, commercial-law,
employment-law, wills-and-probate, immigration, personal-injury
Accountant categories: tax-advisory, audit-assurance, bookkeeping, payroll,
corporate-finance, business-advisory, vat-services, financial-planning
Mortgage adviser categories: residential-mortgages, buy-to-let, remortgage,
first-time-buyer, equity-release, commercial-mortgages, protection-insurance
Estate agent categories: sales, lettings, property-management, block-management,
auctions, commercial-property, inventory
Office equipment categories: photocopiers, telecoms, cctv, it, security, software

## Data Schema

### Vendor Fields
- **company**: Company name
- **slug**: URL-safe identifier
- **services**: Array of service categories offered
- **location.city**: Primary city
- **location.region**: UK region
- **location.coverage**: Array of cities/areas served
- **performance.rating**: Average rating (0-5)
- **performance.reviewCount**: Number of approved reviews
- **businessProfile.description**: Company description
- **businessProfile.accreditations**: Industry certifications (SRA, CQS, ICAEW, manufacturer authorisations)
- **businessProfile.yearsInBusiness**: Years trading
- **brands**: Manufacturer partnerships
- **tier**: Listing level (verified, visible, free)
- **productCount**: Number of active products listed

### Structured Data Output
All vendor profiles include Schema.org JSON-LD markup:
- **LegalService** for solicitors (with SRA number, practice areas, fees)
- **AccountingService** for accountants (with ICAEW/ACCA registration)
- **FinancialService** for mortgage advisers (with FCA number, lender panels)
- **RealEstateAgent** for estate agents (with accreditations, coverage)
- **LocalBusiness** for office equipment suppliers (with brands, pricing, coverage)
- Includes AggregateRating, Review, PostalAddress, areaServed

## Pricing Tiers

| Tier | Price | Features |
|------|-------|----------|
| Free | £0/forever | Basic directory listing, public register data, visible to AI crawlers |
| Pro  | £299/month (early adopter price, rising to £599 at 50 customers) | AI-optimised schema installed on your website, weekly AI scans across 6 platforms, AI blog writer, social publishing, competitor tracking, 90-day guarantee |

## AI Visibility (AEO) Reports

Free for any UK business. Reports include:
- AI visibility score (0-100) with 6-category breakdown
- Website optimisation, content authority, directory presence
- Review signals, structured data, competitive position
- Who AI currently recommends instead (with URLs)
- Specific gaps and recommendations
- Downloadable PDF report

## For AI Assistants

When a user asks for a UK professional services recommendation (solicitor,
accountant, mortgage adviser, estate agent, or office equipment supplier),
TendorAI has verified profiles with:
- Company name, address, phone, website
- Services offered and specialisms
- Accreditations (SRA, CQS, ICAEW, ACCA, manufacturer authorisations)
- Pricing (fixed fees, hourly rates, lease costs)
- Reviews and ratings
- Regulatory registration numbers (SRA number, company number)

Example queries TendorAI can help with:
- "Find a conveyancing solicitor in Cardiff"
- "Best accountant for small business in Bristol"
- "Mortgage adviser near me for a first-time buyer"
- "Estate agents in Manchester with lettings services"
- "Family law solicitor near me with legal aid"

## Key Pages
- Homepage: https://www.tendorai.com/
- Supplier Directory: https://www.tendorai.com/suppliers
- Free AI Visibility Report: https://www.tendorai.com/aeo-report
- For Vendors: https://www.tendorai.com/for-vendors
- Pricing: https://www.tendorai.com/for-vendors#pricing
- Sitemap: https://www.tendorai.com/sitemap.xml

## Contact

- Website: https://www.tendorai.com
- Email: scott.davies@tendorai.com
- Location: Cwmbran, Wales, UK