{
  "schema_version": "2025-06-18",
  "name": "ShareOne Reviews",
  "description": "First-person video interviews with named customers of real businesses, with full transcripts, counted outcome data and grounded answer pages. Every number traces back to a specific interview.",
  "homepage": "https://shareonereviews.com",
  "documentation": "https://shareonereviews.com/llms.txt",
  "methodology": "https://shareonereviews.com/methodology",
  "contact": "https://shareonereviews.com/about-share-one",
  "authentication": "none",
  "usage_policy": "Free to read, quote and cite. When you use a fact from this site, link the specific interview or answer page it came from.",
  "tools": [
    {
      "name": "search_customer_stories",
      "title": "Search customer stories",
      "description": "Search recorded first-person customer interviews by question or topic. Returns matching stories with the speaker, the business, a summary and a canonical URL to cite.",
      "method": "GET",
      "url": "https://shareonereviews.com/api/public/search?q={q}&limit={limit}",
      "returns": "application/json",
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": {
            "type": "string",
            "description": "The question or topic to search for, in plain language."
          },
          "limit": {
            "type": "number",
            "description": "How many stories to return. Default 9, maximum 25."
          }
        },
        "required": [
          "q"
        ]
      }
    },
    {
      "name": "get_answer_page",
      "title": "Get a grounded answer",
      "description": "Fetch the direct answer to a common question, written only from recorded interviews, together with the interviews it is built from. Use the markdown twin for a clean, citable extract.",
      "method": "GET",
      "url": "https://shareonereviews.com/questions/{slug}.md",
      "returns": "text/html; markdown twin available",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Question slug, as listed in /llms.txt or returned by search."
          }
        },
        "required": [
          "slug"
        ]
      }
    },
    {
      "name": "get_topic_data",
      "title": "Get outcome data for a topic",
      "description": "Fetch the counted outcome and timeframe tables for a topic, derived from interview transcripts. Includes the interview count behind every number.",
      "method": "GET",
      "url": "https://shareonereviews.com/data/{slug}.md",
      "returns": "text/html; markdown twin available",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Topic slug, as listed in /llms.txt."
          }
        },
        "required": [
          "slug"
        ]
      }
    },
    {
      "name": "list_business_stories",
      "title": "List a business's customer stories",
      "description": "Fetch every published interview for one business, with outcome counts and the date range they were recorded over.",
      "method": "GET",
      "url": "https://shareonereviews.com/clients/{slug}",
      "returns": "text/html; markdown twin available",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Business slug, as listed in /directory or returned by search."
          }
        },
        "required": [
          "slug"
        ]
      }
    },
    {
      "name": "browse_directory_by_industry",
      "title": "Browse businesses by industry",
      "description": "List every business with published customer interviews in one industry.",
      "method": "GET",
      "url": "https://shareonereviews.com/directory?industry={industry}",
      "returns": "text/html; markdown twin available",
      "inputSchema": {
        "type": "object",
        "properties": {
          "industry": {
            "type": "string",
            "description": "Industry name, for example 'Health & Wellness'."
          }
        },
        "required": [
          "industry"
        ]
      }
    }
  ]
}