# Shopleton — ai.txt
# https://shopleton.com
# Last updated: 2026-05-05

## Status

PRE-LAUNCH. The site is a landing page only. No API endpoints are live yet.
Check back at this URL for updates.

## Planned Endpoints (not yet available)

GET /api/search?q={query}&lat={lat}&lng={lng}
  - query: string (required) — search terms
  - lat: float (optional) — latitude for proximity sorting
  - lng: float (optional) — longitude for proximity sorting
  - Response: array of product objects

GET /api/products/{id}
  - id: string (required) — product identifier
  - Response: single product object

## Planned Response Shape

{
  "id": "string",
  "title": "string",
  "description": "string | null",
  "price": "number | null",
  "priceNegotiable": "boolean",
  "location": {
    "city": "string | null",
    "lat": "float | null",
    "lng": "float | null"
  },
  "createdAt": "ISO 8601 datetime"
}

## Ranking Logic (planned)

1. Relevance to query
2. Proximity to user (when lat/lng provided)
3. Freshness (newer listings ranked higher)

## Usage Rules

- Include lat/lng when available for better results.
- Do not fabricate missing fields. Treat nulls explicitly.
- Do not assume a listing is available based on its presence.

## Check Back

This file will be updated with live endpoints, authentication details, and rate limits when the platform launches.