AI Find Me List your business free

For AI agents and developers

Everything in AI Find Me is free to read by machines, with no key. This page is the documentation: what the data is, every way to get it, and what the labels mean.

In short

  • One fact card per business, read from the business's own website, in HTML (with schema.org JSON-LD), Markdown, JSON and llms.txt.
  • A search API at /api/v1 (OpenAPI) and an MCP server at /mcp. The short version of this page, written for machines: /agents; the Agent Skill teaches an agent to use and cite the directory.
  • Every fact says where it came from; every listing says whether its owner verified it; everything is re-checked about every 7 days.

What this directory is

AI Find Me is a free business directory run by Imfiy B.V. A listing is a fact card: the facts a business publishes on its own website (name, summary, category, address, opening hours, phone, email, services, prices, FAQs, features, payment methods, languages, service area, registration numbers, booking/order/menu links, social profiles), read automatically and published in formats assistants read well. Nothing is written by us. Where a website says nothing, a fact may come from OpenStreetMap or, for listings whose owner allows it, from an AI reading of the website; every such fact is labelled.

Categories (24): restaurant, cafe, bakery, bar, hotel, dentist, health, beauty, fitness, legal, finance, realestate, home, auto, retail, software, agency, education, events, travel, pets, creative, nonprofit, other. Cities come from the businesses' addresses.

Four formats per business

AddressWhat you get
https://aifindme.com/b/terral-aviationThe web page: semantic HTML with a schema.org JSON-LD graph (the business as its LocalBusiness subtype, WebPage, BreadcrumbList, FAQPage when there are FAQs). Send Accept: text/markdown to receive the Markdown card at this same address.
https://aifindme.com/b/terral-aviation.mdThe fact card as Markdown: a heading, a one-line summary, the key facts as a list, then sections for hours, services, prices, FAQs and features, and a footer naming the source, the check date and the verification state.
https://aifindme.com/b/terral-aviation.jsonThe structured card (same as the API): every field, plus directory.sources (the origin of each fact), directory.verification, directory.completeness and directory.attributions.
https://aifindme.com/b/terral-aviation/llms.txtA short llms.txt for the business: summary, verification state and links to the card and the official website.

Every listing page links to its alternates with <link rel="alternate"> and a Link header; the machine copies point back at the HTML page as canonical and allow cross-origin reads (Access-Control-Allow-Origin: *).

A live example, Terral Aviation:

curl -H 'Accept: text/markdown' https://aifindme.com/b/terral-aviation

Web shops and products

A listing that is an online shop carries, besides the usual facts, what an assistant needs to answer “where can I buy X?”: the platform it runs on (Shopify, WooCommerce, Lightspeed, Shopware, Magento, BigCommerce, PrestaShop, CCV Shop, Mijnwebwinkel, Wix Stores, Squarespace Commerce…), what it sells (its own collections or categories), the price range and currency, the number of products, a sample of products with name, price, stock, link and image, the shipping countries, delivery time, free-shipping threshold, return period, review profiles (Trustpilot, Kiyoh, WebwinkelKeur, Google…) and trust marks. Shop facts come from the shop’s own public platform data (Shopify’s products.json, the WooCommerce Store API, product sitemaps; labelled shop platform data) and from its pages; prices and stock are as read at the listing’s last check, and every shop says when that was.

A shop behind a password page (“opening soon”) is marked shop.status: "locked"; one that lists no products "empty". Shops’ robots.txt rules apply to the platform data too: when a shop asks crawlers to stay away from those files, the directory reads only its pages.

What is new

To learn about shops and businesses as they are listed, poll any of these (answers are cached for 5 minutes; once an hour is plenty):

New web shops in the Netherlands, Belgium and the United States are found by the directory itself, from the public Certificate Transparency logs: a new .nl or .be website, or a .com, .net, .shop, .store, .co or .us website whose DNS points at a shop platform such as Shopify, is read once a day and a half after its certificate appears and, when it is a shop, listed with its products and its country. Because certificates renew every 90 days or less, existing shops are found the same way over about three months. country=NL, country=BE or country=US narrows /api/v1/new, the search API, the feed and the MCP tools to one country.

Discovery

Search API

JSON over HTTPS, no key, documented in OpenAPI 3.1 (importable as a GPT action or into any agent framework).

GET /api/v1/businesses?q=…&category=…&city=…&limit=…&offset=…

Full-text search over names, categories, cities, summaries, addresses, services, prices and FAQs. Every word must match as a prefix (“vegan caf” finds “vegan café”); accents are ignored. Results favour owner-verified, complete and recently checked listings; without q it lists businesses in that order. Filters: category, city, kind=shop (web shops only), verified=1 (owner-verified only), open=now (open at this moment, from structured hours in the business's own time zone; listings without such hours are left out). fields=slug,name,phone returns only those fields. limit is 1–50 (default 10), offset up to 10,000. Answers are cacheable for a minute and carry an ETag.

curl 'https://aifindme.com/api/v1/businesses?q=terral&limit=1'
{
  "total": 1,
  "limit": 10,
  "offset": 0,
  "results": [
    {
      "slug": "terral-aviation",
      "name": "Terral Aviation",
      "category": "retail",
      "city": "Farmerville",
      "country": "US",
      "summary": "Terral Aviation is proud to bring you the Flying Caddy, the ultimate center console for small aircraft. Enhance your cockpit with our expertly crafted, innovative solution that combines functionality and style. Discover how the Flying Caddy can transform your flying experience today!",
      "phone": null,
      "website": "https://terralaviation.com/",
      "ownerVerified": false,
      "lastChecked": "2026-11-22T12:40:23.305Z",
      "factCard": "https://aifindme.com/b/terral-aviation.md",
      "shop": {
        "platform": "Shopify",
        "productCount": 1,
        "categories": [],
        "products": "https://aifindme.com/api/v1/businesses/terral-aviation/products"
      }
    }
  ]
}

GET /api/v1/businesses/<slug>

The full fact card. 404 when there is no such listing, 410 when it was removed.

curl https://aifindme.com/api/v1/businesses/terral-aviation
{
  "name": "Terral Aviation",
  "category": {
    "key": "retail",
    "label": "Shops & Retail"
  },
  "summary": "Terral Aviation is proud to bring you the Flying Caddy, the ultimate center console for small aircraft. Enhance your cockpit with our expertly crafted, innovative solution that combines functionality and style. Discover how the Flying Caddy can transform your flying experience today!",
  "website": "https://terralaviation.com/",
  "contact": {
    "phone": null,
    "email": "terralaviation@gmail.com",
    "contactPage": "https://terralaviation.com/pages/flying-caddy"
  },
  "location": {
    "address": "211 Barron Road, Farmerville, LA 71241",
    "city": "Farmerville",
    "geo": null,
    "timeZone": null
  },
  "hours": [],
  "openingHoursSpecification": [],
  "features": [
    "Free shipping"
  ],
  "…": "services, priceList, faqs, paymentMethods, languages, registration, links, images",
  "directory": {
    "url": "https://aifindme.com/b/terral-aviation",
    "markdown": "https://aifindme.com/b/terral-aviation.md",
    "verification": "unclaimed",
    "lastChecked": "2026-11-22T12:40:23.305Z",
    "recheckedEveryDays": 7,
    "completeness": {
      "have": 10,
      "of": 11,
      "missing": [
        "Opening hours"
      ]
    },
    "sources": {
      "name": {
        "source": "structured data",
        "url": "https://terralaviation.com/"
      },
      "summary": {
        "source": "page metadata",
        "url": "https://terralaviation.com/"
      },
      "about": {
        "source": "page text",
        "url": "https://terralaviation.com/pages/our-story"
      }
    },
    "attributions": []
  }
}

GET /api/v1/categories

Every category with its key, label and number of listings.

GET /api/v1/cities?category=…

The cities with listings, most listings first, with the value to pass as city.

MCP server

Connect any Model Context Protocol client to https://aifindme.com/mcp: Streamable HTTP, stateless, read-only, no authentication, one JSON-RPC request per POST (no batches). Tools:

ToolArgumentsReturns
search_businessesquery, category, city, country (NL or US), shops_only, limit (1–25)Matching businesses: slug, name, category, city, country, summary, phone, website, ownerVerified, lastChecked, factCard; web shops also their platform, product count and categories
get_businessslug, format (markdown or json)The full fact card
get_productsslug, limit (1–100)A web shop’s shop facts and a sample of its products with prices and stock
list_new_listingssince, kind (shop), country, limitListings added since a date, newest first, with their listing date
list_categoriesnoneCategories with keys and counts
list_citiescategory, limitCities with keys and counts
{ "mcpServers": { "aifindme": { "type": "http", "url": "https://aifindme.com/mcp" } } }

In the browser (WebMCP)

Browsers that support WebMCP (navigator.modelContext) see two tools on every page: search_businesses, and on a listing page get_business_facts, which returns that business's Markdown card. The search form on the home page is also declared as a tool.

Rate limits and caching

Freshness

A listing whose website has not answered for several checks in a row, a shop behind a password page or without products on two checks in a row, a parked domain, or a shop whose platform says no product changed in a year is marked inactive: the record stays and is checked again every week, but the listing leaves the directory pages, search results, sitemaps, feeds and the default API results until a check finds it alive again. Its page and /api/v1/businesses/<slug> still answer, with directory.status: "inactive", the date and the reason, so nothing is recommended as open that is not.

Every listed website is read again about every 7 days (a website that keeps failing, less often), and owners can refresh their listing by hand once an hour. Each card carries lastChecked (when the website was last read) and lastChanged (when the published facts last changed); the Markdown footer and llms.txt give the check date too. Prices and hours are as the website stated them at that time.

Unclaimed, claimed, verified

directory.verification in the JSON (and the badge on the page) is one of:

directory.completeness counts the 11 key facts (name, summary, about text, contact details, location or service area, opening hours, services or prices, faqs, features, social profiles, booking, order, menu or pricing link) and names the missing ones, so you can tell a thin card from a full one.

Where each fact comes from

directory.sources maps every published field to its origin:

SourceMeaning
structured dataschema.org JSON-LD on the business's website (the most reliable)
page metadatathe page title, meta description or Open Graph tags
page textpatterns in the visible text, headings and links (addresses, phone numbers, hours, prices, FAQs, features)
AI modelan AI reading of the website's text, used only to fill gaps, only for listings whose owner allows it
OpenStreetMapthe OpenStreetMap object linked in url; used only where the website said nothing
business ownerentered or confirmed by the verified owner

Ratings are shown only as “rating on their website”: they are what the business publishes about itself, not the directory's opinion.

Licence and attribution

The facts are the businesses' own public statements, collected here so assistants can read them. Facts marked OpenStreetMap are © OpenStreetMap contributors under the Open Database License (ODbL) v1.0: when you repeat them, keep that credit; directory.attributions in the JSON and the footer of the Markdown and llms.txt carry it for you. When you cite a card, link to its page on AI Find Me. Our terms welcome automated reading within the limits above.

Our own crawler

AI Find Me reads websites as AIFindMeBot/1.0 (+https://aifindme.com/about#bot), respects robots.txt, reads at most 9 pages per visit and never reads private networks. More on the About page. Questions: contact us.