YourAITools YourAITools Listings API

The YourAITools Listings API from YourAITools — 5 operation(s) for youraitools listings.

GitHub OpenAPI

Operations 5

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

POST /listing/v1/fast-track Fast-track review: 19.00 USDC #
POST /listing/v1/launch Launch bundle: 49.00 USDC #
GET /listing/v1/status/{ref} Free: status of a paid submission (no email shown) #
GET /listing/v1/tiers Free: tiers, prices and terms observed #

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/youraitools-co:youraitools-co-youraitools-listings-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.

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

OpenAPI Specification

youraitools-co-youraitools-listings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YourAITools Listings API
  version: 1.0.0
  description: Pay-per-call tools for AI agents, paid per request in USDC via x402 on Base, Polygon, Arbitrum One or Solana, with each tool's own spec at https://api.youraitools.co//openapi.json.
  contact:
    email: hello@youraitools.co
    url: https://youraitools.co/built-by-us
servers:
- url: https://api.youraitools.co
tags:
- name: YourAITools Listings
paths:
  /listing/v1/fast-track:
    post:
      operationId: listing_fast_track
      summary: 'Fast-track review: 19.00 USDC'
      description: 'Your tool is reviewed within 24 hours of payment (the free queue is reviewed in the normal daily run) and, if approved, published on youraitools.co. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises. Search intents: submit ai tool, ai tool directory listing, list my ai tool, ai tools directory, launch ai product, ai tool submission.'
      tags:
      - YourAITools Listings
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '19.00'
        protocols:
        - x402: {}
      x-x402:
        scheme: exact
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        amount: '19000000'
        assetSymbol: USDC
        x402Versions:
        - 2
        - 1
        networks:
        - network: eip155:8453
          name: Base
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:137
          name: Polygon
          asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:42161
          name: Arbitrum One
          asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
          name: Solana
          asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          symbol: USDC
          payTo: FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tool_url
              - name
              - contact_email
              - category
              additionalProperties: true
              properties:
                tool_url:
                  type: string
                  format: uri
                  maxLength: 500
                  description: Public https URL of the tool, API or its docs
                  example: https://example.com
                name:
                  type: string
                  minLength: 2
                  maxLength: 80
                  example: Example Tool
                contact_email:
                  type: string
                  format: email
                  maxLength: 254
                  description: Only used to contact you about this submission; never shown publicly
                  example: you@example.com
                category:
                  type: string
                  minLength: 2
                  maxLength: 48
                  example: x402 API
                description:
                  type: string
                  maxLength: 600
                  description: 'Optional: one or two sentences on what it does'
                notes:
                  type: string
                  maxLength: 1000
                  description: 'Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)'
      responses:
        '200':
          description: 'Paid and settled: submission received'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ref:
                    type: string
                    pattern: ^LST-[0-9A-HJKMNP-TV-Z]{10}$
                  status:
                    type: string
                    enum:
                    - received
                  tier:
                    type: string
                  review_by:
                    type: string
                    format: date-time
                  status_url:
                    type: string
                  payment:
                    type: object
                  terms:
                    type: string
        '400':
          description: Invalid body (checked before payment, so no 402 and never charged)
        '402':
          description: Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}
        '503':
          description: Storage unavailable (never charged)
  /listing/v1/launch:
    post:
      operationId: listing_launch
      summary: 'Launch bundle: 49.00 USDC'
      description: 'Fast-track review within 24 hours, plus 30 days of Featured placement on youraitools.co once approved, plus one line in the YourAITools newsletter once it has subscribers (it has none yet). Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises. Search intents: ai tool launch, featured ai tool listing, promote ai tool, ai directory featured, launch ai product, ai tool marketing.'
      tags:
      - YourAITools Listings
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '49.00'
        protocols:
        - x402: {}
      x-x402:
        scheme: exact
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        amount: '49000000'
        assetSymbol: USDC
        x402Versions:
        - 2
        - 1
        networks:
        - network: eip155:8453
          name: Base
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:137
          name: Polygon
          asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:42161
          name: Arbitrum One
          asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
          name: Solana
          asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          symbol: USDC
          payTo: FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tool_url
              - name
              - contact_email
              - category
              additionalProperties: true
              properties:
                tool_url:
                  type: string
                  format: uri
                  maxLength: 500
                  description: Public https URL of the tool, API or its docs
                  example: https://example.com
                name:
                  type: string
                  minLength: 2
                  maxLength: 80
                  example: Example Tool
                contact_email:
                  type: string
                  format: email
                  maxLength: 254
                  description: Only used to contact you about this submission; never shown publicly
                  example: you@example.com
                category:
                  type: string
                  minLength: 2
                  maxLength: 48
                  example: x402 API
                description:
                  type: string
                  maxLength: 600
                  description: 'Optional: one or two sentences on what it does'
                notes:
                  type: string
                  maxLength: 1000
                  description: 'Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)'
      responses:
        '200':
          description: 'Paid and settled: submission received'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ref:
                    type: string
                    pattern: ^LST-[0-9A-HJKMNP-TV-Z]{10}$
                  status:
                    type: string
                    enum:
                    - received
                  tier:
                    type: string
                  review_by:
                    type: string
                    format: date-time
                  status_url:
                    type: string
                  payment:
                    type: object
                  terms:
                    type: string
        '400':
          description: Invalid body (checked before payment, so no 402 and never charged)
        '402':
          description: Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}
        '503':
          description: Storage unavailable (never charged)
  /listing/v1/featured:
    post:
      operationId: listing_featured
      summary: 'Featured, 30 days: 29.00 USDC'
      description: 'Reviewed within 48 hours of payment (tools not yet listed are reviewed first) and, if approved, shown as Featured (badge, pinned in its category, marked as paid placement) on youraitools.co for 30 days. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises. Search intents: featured ai tool, promote ai tool, ai directory advertising, sponsored ai tool listing, ai tool visibility, featured listing.'
      tags:
      - YourAITools Listings
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '29.00'
        protocols:
        - x402: {}
      x-x402:
        scheme: exact
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        amount: '29000000'
        assetSymbol: USDC
        x402Versions:
        - 2
        - 1
        networks:
        - network: eip155:8453
          name: Base
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:137
          name: Polygon
          asset: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: eip155:42161
          name: Arbitrum One
          asset: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831'
          symbol: USDC
          payTo: '0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F'
        - network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
          name: Solana
          asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
          symbol: USDC
          payTo: FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - tool_url
              - name
              - contact_email
              - category
              additionalProperties: true
              properties:
                tool_url:
                  type: string
                  format: uri
                  maxLength: 500
                  description: Public https URL of the tool, API or its docs
                  example: https://example.com
                name:
                  type: string
                  minLength: 2
                  maxLength: 80
                  example: Example Tool
                contact_email:
                  type: string
                  format: email
                  maxLength: 254
                  description: Only used to contact you about this submission; never shown publicly
                  example: you@example.com
                category:
                  type: string
                  minLength: 2
                  maxLength: 48
                  example: x402 API
                description:
                  type: string
                  maxLength: 600
                  description: 'Optional: one or two sentences on what it does'
                notes:
                  type: string
                  maxLength: 1000
                  description: 'Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)'
      responses:
        '200':
          description: 'Paid and settled: submission received'
          content:
            application/json:
              schema:
                type: object
                properties:
                  ref:
                    type: string
                    pattern: ^LST-[0-9A-HJKMNP-TV-Z]{10}$
                  status:
                    type: string
                    enum:
                    - received
                  tier:
                    type: string
                  review_by:
                    type: string
                    format: date-time
                  status_url:
                    type: string
                  payment:
                    type: object
                  terms:
                    type: string
        '400':
          description: Invalid body (checked before payment, so no 402 and never charged)
        '402':
          description: Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}
        '503':
          description: Storage unavailable (never charged)
  /listing/v1/status/{ref}:
    get:
      operationId: listing_status
      summary: 'Free: status of a paid submission (no email shown)'
      security: []
      parameters:
      - name: ref
        in: path
        required: true
        schema:
          type: string
          pattern: ^LST-[0-9A-HJKMNP-TV-Z]{10}$
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  ref:
                    type: string
                  status:
                    type: string
                    enum:
                    - received
                    - approved
                    - rejected
                    - refund_pending
                    - refunded
                  tier:
                    type: string
                  name:
                    type: string
                  tool_url:
                    type: string
                  category:
                    type: string
                  received_at:
                    type: string
                  review_by:
                    type: string
                  decided_at:
                    type:
                    - string
                    - 'null'
                  featured_from:
                    type: string
                  featured_until:
                    type: string
                  payment:
                    type:
                    - object
                    - 'null'
                  refund:
                    type: object
        '404':
          description: Unknown ref
        '429':
          description: Rate limited
      tags:
      - YourAITools Listings
  /listing/v1/tiers:
    get:
      operationId: listing_tiers
      summary: 'Free: tiers, prices and terms'
      security: []
      responses:
        '200':
          description: OK
      tags:
      - YourAITools Listings
components:
  securitySchemes:
    creditsKey:
      type: http
      scheme: bearer
      description: yatc_... credits key