FastAF AI API

The Ai API from FastAF — 2 operation(s) for ai.

Operations 3

GET /v1/ai AI-assisted search #
POST /v1/ai AI-assisted search #
GET /x402/v1/ai AI-assisted search #

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/fastaf:fastaf-ai-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

fastaf-ai-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: FastAF AI API
  version: v1
  contact:
    email: support@fastaf.co
    url: https://fastaf.co/docs/#x402
  description: 'FastAF is a web data API for AI agents: Google SERP, Maps, ecommerce, web scraping, AI extraction, screenshots, news, jobs, research, public profiles and video transcripts. Use prepaid API keys or account-free x402 v2 payments.'
  x-guidance: 'Use GET /x402/v1/{endpoint} with query parameters (not POST or a JSON body). Choose serp for Google search, maps for places, news/shopping/scholar/jobs for specialized search, ai for Google AI Mode, amazon/youtube for their resource variants, linkedin/x for public profiles, walmart/zillow/ebay for structured commerce or listings, scrape for public HTML or markdown, and screenshot for images. Use the dedicated zillow and ebay endpoints instead of scrape for those sites. The q and lang aliases are accepted for query (search_query on YouTube) and language. Send a valid unpaid request first; read the x402 v2 PAYMENT-REQUIRED header, sign with an x402 client such as @x402/fetch, and retry the identical URL with PAYMENT-SIGNATURE. USDC payment uses the network and amount in that live challenge; no API-key authentication is needed. Only successful results are settled; inspect PAYMENT-RESPONSE for the receipt. Prices here are decimal USD, while the challenge uses USDC atomic units (six decimals). Dynamic prices depend on advance_search (serp), resource (amazon/youtube), or rendering, proxies/country and AI extraction (scrape). Scrape site defaults, including Booking rendering and Reddit feed mode, are applied before quoting. A bare unsigned URL returns a default-variant discovery quote only: add valid parameters and request a new challenge before paying. Unpaid HEAD probes also return PAYMENT-REQUIRED with no body; use GET, not HEAD, to pay for data. Invalid parameterized requests and blocked targets return 400; payment headers never bypass validation. Never reuse a settled signature for a new call. Respect Retry-After on rate/capacity errors. For the separate prepaid-key API and authenticated credit-pack top-up, see /v1/openapi.json. Get a free API key at https://fastaf.co/signup/ with an email address, terms acceptance and browser verification. No card is required. POST /public/signup sends an email confirmation link and sets a dashboard session cookie; it does not return an API key. Follow the emailed GET /public/signin/{token} link, then create a key in the dashboard (POST /v1/keys with the session cookie). The key is shown only once. Email confirmation unlocks 2 free calls per account in total, not per day, shared across all keys and all offered REST/MCP endpoints, valid for 12 months; failed calls restore their slot. Unverified trial accounts receive email_verification_required (403) before any data call or trial reservation. Signups are limited per IPv4 /24 or IPv6 /64 network per UTC day (default 3); 429 means retry after the reset. GET /v1/usage reports free_requests_remaining separately from balance_credits. POST /v1/signup is retired and always returns 410 signup_disabled. Agents without an inbox can use /x402/v1/{endpoint} without an account.'
  x-signup-guidance: Get a free API key at https://fastaf.co/signup/ with an email address, terms acceptance and browser verification. No card is required. POST /public/signup sends an email confirmation link and sets a dashboard session cookie; it does not return an API key. Follow the emailed GET /public/signin/{token} link, then create a key in the dashboard (POST /v1/keys with the session cookie). The key is shown only once. Email confirmation unlocks 2 free calls per account in total, not per day, shared across all keys and all offered REST/MCP endpoints, valid for 12 months; failed calls restore their slot. Unverified trial accounts receive email_verification_required (403) before any data call or trial reservation. Signups are limited per IPv4 /24 or IPv6 /64 network per UTC day (default 3); 429 means retry after the reset. GET /v1/usage reports free_requests_remaining separately from balance_credits. POST /v1/signup is retired and always returns 410 signup_disabled. Agents without an inbox can use /x402/v1/{endpoint} without an account.
servers:
- url: https://api.fastaf.co
tags:
- name: AI
paths:
  /v1/ai:
    get:
      tags:
      - AI
      summary: AI-assisted search
      description: Google AI Mode answer for a question, as JSON text blocks with the cited links. Empty answers are not charged.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Provider response.
          headers:
            X-FastAF-Credits-Used:
              schema:
                type: integer
            X-FastAF-Cost-Version:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  text_blocks:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        snippet:
                          type: string
                        links:
                          type: array
                          items:
                            type: object
                            properties:
                              link:
                                type: string
                            additionalProperties: true
                      additionalProperties: true
                additionalProperties: true
              example:
                text_blocks:
                - type: paragraph
                  snippet: An x402 server returns a payment request with HTTP 402; the client signs it and retries the request.
                  links:
                  - link: https://www.x402.org/
            text/html:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
      x-fastaf-credit-cost: 10
      x-fastaf-cost-version: v1
      operationId: getAi
      parameters:
      - name: query
        in: query
        required: true
        description: Required question/search text for Google AI Mode, e.g. How does an espresso machine work? No default. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: country
        in: query
        required: false
        description: Two-letter search country code, e.g. us, uk or fr; default us. Localizes results, not a scrape proxy selection. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: language
        in: query
        required: false
        description: Result/interface language code, e.g. en, es, fr or de; default en. Use lr, where supported, to restrict document languages. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: uule
        in: query
        required: false
        description: Google's encoded geographic search token, copied from a Google URL. Omit for no explicit token; do not combine with location where supported. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: location
        in: query
        required: false
        description: City-level search origin, e.g. Austin, Texas, United States; omit for source-default location. Cannot be combined with uule. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: safe
        in: query
        required: false
        description: 'Adult-content filter: active enables SafeSearch; off disables it (default off). No option surcharge; 10 credits per successful request.'
        schema:
          type: string
          maxLength: 8192
      - name: html
        in: query
        required: false
        description: Return raw source HTML instead of parsed JSON when true; true/false, default false. No option surcharge; 10 credits per successful request.
        schema:
          type: boolean
    post:
      tags:
      - AI
      summary: AI-assisted search
      description: Google AI Mode answer for a question, as JSON text blocks with the cited links. Empty answers are not charged.
      security:
      - bearerAuth: []
      responses:
        '200':
          description: Provider response.
          headers:
            X-FastAF-Credits-Used:
              schema:
                type: integer
            X-FastAF-Cost-Version:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  text_blocks:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        snippet:
                          type: string
                        links:
                          type: array
                          items:
                            type: object
                            properties:
                              link:
                                type: string
                            additionalProperties: true
                      additionalProperties: true
                additionalProperties: true
              example:
                text_blocks:
                - type: paragraph
                  snippet: An x402 server returns a payment request with HTTP 402; the client signs it and retries the request.
                  links:
                  - link: https://www.x402.org/
            text/html:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '502':
          $ref: '#/components/responses/BadGateway'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
      x-fastaf-credit-cost: 10
      x-fastaf-cost-version: v1
      operationId: postAi
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                query:
                  type: string
                  maxLength: 8192
                  description: Required question/search text for Google AI Mode, e.g. How does an espresso machine work? No default. No option surcharge; 10 credits per successful request.
                country:
                  type: string
                  maxLength: 8192
                  description: Two-letter search country code, e.g. us, uk or fr; default us. Localizes results, not a scrape proxy selection. No option surcharge; 10 credits per successful request.
                language:
                  type: string
                  maxLength: 8192
                  description: Result/interface language code, e.g. en, es, fr or de; default en. Use lr, where supported, to restrict document languages. No option surcharge; 10 credits per successful request.
                uule:
                  type: string
                  maxLength: 8192
                  description: Google's encoded geographic search token, copied from a Google URL. Omit for no explicit token; do not combine with location where supported. No option surcharge; 10 credits per successful request.
                location:
                  type: string
                  maxLength: 8192
                  description: City-level search origin, e.g. Austin, Texas, United States; omit for source-default location. Cannot be combined with uule. No option surcharge; 10 credits per successful request.
                safe:
                  type: string
                  maxLength: 8192
                  description: 'Adult-content filter: active enables SafeSearch; off disables it (default off). No option surcharge; 10 credits per successful request.'
                html:
                  type: boolean
                  description: Return raw source HTML instead of parsed JSON when true; true/false, default false. No option surcharge; 10 credits per successful request.
              required:
              - query
  /x402/v1/ai:
    get:
      operationId: x402GetAi
      summary: AI-assisted search
      description: Google AI Mode answer for a question, as JSON text blocks with the cited links. Empty answers are not charged. Send query parameters, not a JSON body. The PAYMENT-REQUIRED header quotes the exact price for the selected options; sign it with an x402 v2 client and retry the same URL with PAYMENT-SIGNATURE. Invalid parameters or blocked targets return 400 without payment. Only successful calls are settled.
      tags:
      - AI
      x-category: ai
      x-output-schema:
        anyOf:
        - type: object
          properties:
            text_blocks:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  snippet:
                    type: string
                  links:
                    type: array
                    items:
                      type: object
                      properties:
                        link:
                          type: string
                      additionalProperties: true
                additionalProperties: true
          additionalProperties: true
        - type: string
      security: []
      x-payment-info:
        protocols:
        - x402: {}
        price:
          mode: fixed
          currency: USD
          amount: '0.010000'
      parameters:
      - name: query
        in: query
        required: true
        description: Required question/search text for Google AI Mode, e.g. How does an espresso machine work? No default. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
          example: how do x402 payments work
        example: how do x402 payments work
      - name: country
        in: query
        required: false
        description: Two-letter search country code, e.g. us, uk or fr; default us. Localizes results, not a scrape proxy selection. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: language
        in: query
        required: false
        description: Result/interface language code, e.g. en, es, fr or de; default en. Use lr, where supported, to restrict document languages. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: uule
        in: query
        required: false
        description: Google's encoded geographic search token, copied from a Google URL. Omit for no explicit token; do not combine with location where supported. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: location
        in: query
        required: false
        description: City-level search origin, e.g. Austin, Texas, United States; omit for source-default location. Cannot be combined with uule. No option surcharge; 10 credits per successful request.
        schema:
          type: string
          maxLength: 8192
      - name: safe
        in: query
        required: false
        description: 'Adult-content filter: active enables SafeSearch; off disables it (default off). No option surcharge; 10 credits per successful request.'
        schema:
          type: string
          maxLength: 8192
      - name: html
        in: query
        required: false
        description: Return raw source HTML instead of parsed JSON when true; true/false, default false. No option surcharge; 10 credits per successful request.
        schema:
          type: boolean
      responses:
        '200':
          description: Successful result; payment settled. Content type depends on the requested format.
          headers:
            PAYMENT-RESPONSE:
              description: Base64-encoded x402 v2 settlement receipt.
              schema:
                type: string
            X-FastAF-Credits-Used:
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                type: object
                properties:
                  text_blocks:
                    type: array
                    items:
                      type: object
                      properties:
                        type:
                          type: string
                        snippet:
                          type: string
                        links:
                          type: array
                          items:
                            type: object
                            properties:
                              link:
                                type: string
                            additionalProperties: true
                      additionalProperties: true
                additionalProperties: true
              example:
                text_blocks:
                - type: paragraph
                  snippet: An x402 server returns a payment request with HTTP 402; the client signs it and retries the request.
                  links:
                  - link: https://www.x402.org/
            text/html:
              schema:
                type: string
        '400':
          description: Invalid parameters or blocked target; nothing charged.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          $ref: '#/components/responses/X402PaymentRequired'
        '404':
          description: Pay-per-call is not enabled on this deployment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: This signed payment is already in use or has already paid for a call.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: The requested resource is unavailable; nothing settled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: IP burst limit reached. Retry after the Retry-After header interval.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Upstream failed, or returned blocked, empty or incomplete data; nothing settled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Service, capacity or payment configuration unavailable; retry later.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: Upstream timed out; nothing settled.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  responses:
    BadGateway:
      description: The upstream request failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    PaymentRequired:
      description: The account has insufficient credits.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: A rate or concurrency limit was reached.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Invalid request or parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The account is suspended or email verification is required before data calls.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: A valid bearer API key is required.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServiceUnavailable:
      description: The service is temporarily unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    GatewayTimeout:
      description: The upstream request timed out.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    X402PaymentRequired:
      description: 'Payment required. Decode PAYMENT-REQUIRED (base64 JSON) for the authoritative x402 v2 accepts[].amount in USDC atomic units, network, asset and payTo. The JSON body also includes x402Version, resource and accepts, with maxAmountRequired and per-requirement resource/description/mimeType aliases for catalogs. This remains a v2 payment flow: sign and retry with PAYMENT-SIGNATURE. A failed settlement also returns 402 (settlement_failed) with PAYMENT-RESPONSE instead of data, without a payment challenge.'
      headers:
        PAYMENT-REQUIRED:
          description: Base64-encoded x402 v2 payment challenge (present on unpaid requests).
          schema:
            type: string
        PAYMENT-RESPONSE:
          description: Base64-encoded settlement failure receipt, when settlement fails.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PaymentRequired'
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
    PaymentRequired:
      allOf:
      - $ref: '#/components/schemas/Error'
      - type: object
        properties:
          x402Version:
            type: integer
            const: 2
          resource:
            type: object
            required:
            - url
            - description
            - mimeType
            description: The resource object from PAYMENT-REQUIRED, including discovery metadata.
            properties:
              url:
                type: string
                format: uri
              description:
                type: string
              mimeType:
                type: string
          accepts:
            type: array
            minItems: 1
            description: The v2 header requirements plus legacy discovery aliases. Present on payment challenges, not settlement failures.
            items:
              type: object
              required:
              - scheme
              - network
              - amount
              - maxAmountRequired
              - resource
              - description
              - mimeType
              - payTo
              - asset
              - maxTimeoutSeconds
              - extra
              properties:
                scheme:
                  type: string
                  const: exact
                network:
                  type: string
                  description: CAIP-2 network identifier, unchanged from the v2 header.
                amount:
                  type: string
                  pattern: ^[0-9]+$
                maxAmountRequired:
                  type: string
                  pattern: ^[0-9]+$
                  description: Alias of amount, in atomic USDC units.
                resource:
                  type: string
                  format: uri
                description:
                  type: string
                mimeType:
                  type: string
                payTo:
                  type: string
                asset:
                  type: string
                maxTimeoutSeconds:
                  type: integer
                extra:
                  type: object
                  additionalProperties: true
          price:
            type: object
            required:
            - usd
            - credits
            - asset
            - network
            properties:
              usd:
                type: string
                pattern: ^[0-9]+\.[0-9]{6}$
              credits:
                type: integer
                minimum: 1
              asset:
                type: string
                const: USDC
              network:
                type: string
                description: CAIP-2 network identifier.
          how_to_pay:
            type: string
          with_a_key:
            type: string
          docs:
            type: string
            format: uri
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    sessionCookie:
      type: apiKey
      in: cookie
      name: fastaf_session