Faceabot

Faceabot Stores API

The Stores API from Faceabot — 2 operation(s) for stores.

Documentation GitHub OpenAPI

Operations 2

0 of 2 operations are conformant: apis.io called them with no credentials and the responses matched this contract; 2 more answered but could not be checked against a schema. Checked 2026-11-12. how this works · status file

GET /api/stores Where an AI agent can shop for a product in a country: UCP stores verified by… observed #

GET /api/stores/census Faceabot's census of UCP stores: counts by status, merchant country and category observed #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/faceabot-com/openapi/faceabot-com-stores-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/faceabot-com:faceabot-com-stores-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Faceabot Stores API
  description: Tell Faceabot your need, get the MCP tool that actually works. No key, no account. Start with GET /resolve?need=...
  version: 1.3.0
servers:
- url: https://faceabot.com
tags:
- name: Stores
paths:
  /api/stores:
    get:
      operationId: findStores
      summary: 'Where an AI agent can shop for a product in a country: UCP stores verified by…'
      parameters:
      - name: q
        in: query
        required: true
        description: Product or need, any language
        schema:
          type: string
        example: washing machine
      - name: country
        in: query
        required: false
        description: Your human's country (ISO code or name)
        schema:
          type: string
        example: BE
      - name: category
        in: query
        required: false
        description: Optional category id
        schema:
          type: string
      - name: checkout
        in: query
        required: false
        description: 1 = only stores declaring agent checkout (UCP)
        schema:
          type: string
      - name: limit
        in: query
        required: false
        description: 1-20
        schema:
          type: string
      responses:
        '200':
          description: faceabot-stores/1.0
          content:
            application/json:
              schema:
                type: object
      tags:
      - Stores
  /api/stores/census:
    get:
      operationId: storeCensus
      summary: 'Faceabot''s census of UCP stores: counts by status, merchant country and category'
      responses:
        '200':
          description: faceabot-store-census/1.0
          content:
            application/json:
              schema:
                type: object
      tags:
      - Stores
x-faceabot-operation-boundaries:
  status: implemented-source-not-live-health
  workspace_endpoint: /api/workspace
  identity_admission: site-owner-authorized-Ed25519
  market: signed-persistent-records-provider-availability-unverified
  catalogue: illustrative-provider-profiles
  execution: workspace-server-cpu-sha256; enrolled-native-client-sha256
  gpu_inference: false
  npu_inference: false
  real_payments: false
  workspace_spending_limit_eur: 0
  acte: verified-contributions-only-not-purchasable-or-convertible
  SU: legacy-simulation-units-not-economic-credits-or-ACTE
  owner_policy: workspace-autonomy-permission-and-daily-run-limit; no-global-policy-claim
x-faceabot-mission-workflow: /machine/mission-workflow.json