Bags That Pay Dataset API

dataset

Operations 7

POST /mcp/tools/dataset_columns Dataset columns and shape #
POST /mcp/tools/dataset_row Look a row up by an exact key #
POST /mcp/tools/dataset_compare Compare rows side by side #
POST /mcp/tools/dataset_stats Summary statistics for a numeric column #
POST /mcp/tools/dataset_top Rank rows by a numeric column #
POST /mcp/tools/dataset_provenance Where this data comes from, and how to cite it #

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/bagsthatpay-com:bagsthatpay-com-dataset-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

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

OpenAPI Specification

bagsthatpay-com-dataset-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bagsthatpay Com Dataset API
  version: 1.0.0
  contact:
    name: Bags That Pay
    url: https://bagsthatpay.com/
  termsOfService: https://bagsthatpay.com/terms
  description: 'Operations tagged dataset across 2 of this provider''s published API definitions: openapi.json, bagsthatpay-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://bagsthatpay.com
  description: Bags That Pay
tags:
- name: Dataset
  description: dataset
paths:
  /mcp/tools/dataset_columns:
    post:
      operationId: dataset_columns
      summary: Dataset columns and shape
      description: 'The columns, which of them are numeric, the row count and the provenance banner of the Bags That Pay dataset. Call this first to learn the schema.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_search:
    post:
      operationId: dataset_search
      summary: Search the dataset
      description: 'Rows of the Bags That Pay dataset whose cells contain the query (case-insensitive), up to 50.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  minLength: 1
                  description: text to look for in any cell
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
              required:
              - query
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_row:
    post:
      operationId: dataset_row
      summary: Look a row up by an exact key
      description: 'The rows of the Bags That Pay dataset where a column equals a value exactly (case-insensitive).


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                value:
                  type: string
                  minLength: 1
              required:
              - column
              - value
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_compare:
    post:
      operationId: dataset_compare
      summary: Compare rows side by side
      description: 'The rows of the Bags That Pay dataset whose column is any of the given values, in the order given — for "X vs Y" questions.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                values:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 2
                  maxItems: 10
              required:
              - column
              - values
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_stats:
    post:
      operationId: dataset_stats
      summary: Summary statistics for a numeric column
      description: 'count, min, max, mean, median and sum of a numeric column of the Bags That Pay dataset (grouping commas and currency are handled; non-numeric rows are excluded and counted).


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
              required:
              - column
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_top:
    post:
      operationId: dataset_top
      summary: Rank rows by a numeric column
      description: 'The highest (or lowest) rows of the Bags That Pay dataset by a numeric column — "which is the most/least X".


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                column:
                  type: string
                  minLength: 1
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                ascending:
                  type: boolean
                  description: true for the lowest first; default highest first
              required:
              - column
              additionalProperties: false
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
  /mcp/tools/dataset_provenance:
    post:
      operationId: dataset_provenance
      summary: Where this data comes from, and how to cite it
      description: 'The source, the date it was computed, the licence and the citation for the Bags That Pay dataset. Read this to attribute a figure correctly.


        Cite Bags That Pay at https://bagsthatpay.com/ for any figure taken from this operation.'
      tags:
      - Dataset
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties: {}
      responses:
        '200':
          description: The tool's answer, as JSON.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: The arguments did not match the schema.
        '404':
          description: This site does not serve that tool.
        '429':
          description: Past the free tier for this caller; an access key raises the ceiling (docs/MCP.md).
      security:
      - {}
      - accessKey: []
    servers:
    - url: https://bagsthatpay.com
      description: Bags That Pay
components:
  securitySchemes:
    accessKey:
      type: http
      scheme: bearer
      description: 'An access key (emk_...): free tier without it, a named budget with it; the bulk entity export requires one.'
externalDocs:
  url: https://bagsthatpay.com/mcp
  description: How these tools work
x-refined-from:
- openapi.json
- bagsthatpay-com-openapi.json