Andrew’s Freebies Trials API

openapi: 3.2.0
info:
  title: Andrew’s Freebies Trials API
  version: 2.6.0
  description: Open access to one preferred search for evidence-backed free trials and U.S. savings. Matching answer guides are returned separately from normalized records only while their lifecycle, copy fingerprint, and supporting-record set remain current. The broader public-benefit corpus and live licensed repositories are available through explicit scopes. Public reads and anonymous actionable-offer outcome reports require no API key; verification ingestion is operator-authenticated. Qualified AI-agent handoffs require Cloudflare verification of the recognized user-agent so spoofed agent labels cannot become adoption evidence. Outcomes separate primary site search from supplemental enrichment, filtering, pagination, and browse resets.
servers:
- url: https://andrewsfreebies.com
tags:
- name: Trials
paths:
  /api/v1/trials:
    get:
      operationId: searchTrials
      summary: Search free trials
      parameters:
      - name: q
        in: query
        schema:
          type: string
        description: Natural-language capability or provider query.
      - name: category
        in: query
        schema:
          type: string
      - name: card
        in: query
        schema:
          type: string
          enum:
          - no-card
      - name: offer_type
        in: query
        schema:
          type: string
          enum:
          - free-trial
          - free-plan
          - money-back-guarantee
          - promotional-offer
          - directory-listing
      - name: status
        in: query
        schema:
          type: string
          enum:
          - verified
          - source-found
          - conditional
          - directory-listed
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 50
      - name: offset
        in: query
        schema:
          type: integer
          minimum: 0
          default: 0
      responses:
        '200':
          description: A paginated list of matching trials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
      tags:
      - Trials
  /api/v1/trials/{slug}:
    get:
      operationId: getTrial
      summary: Get one free-trial record
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Trial record
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Trial'
        '404':
          description: Not found
      tags:
      - Trials
components:
  schemas:
    SearchResponse:
      type: object
      properties:
        count:
          type: integer
        returned:
          type: integer
        next:
          type:
          - string
          - 'null'
        items:
          type: array
          items:
            $ref: '#/components/schemas/Trial'
    VerificationReadiness:
      type: object
      required:
      - status
      - latest_outcome
      - latest_checked_at
      - interpretation
      properties:
        status:
          type: string
          enum:
          - audit-confirmed-exact
          - audit-confirmed-partial
          - audit-inconclusive
          - audit-warning
          - not-audited
        latest_outcome:
          oneOf:
          - $ref: '#/components/schemas/VerificationOutcome'
          - type: 'null'
        latest_checked_at:
          type:
          - string
          - 'null'
          format: date-time
        interpretation:
          type: string
          description: Factual guidance for using the latest audit without treating an inconclusive fetch as expiration.
    Trial:
      type: object
      required:
      - id
      - name
      - provider
      - offer_type
      - trial
      - activation
      - status
      - source
      - verification_readiness
      - action_url
      - official_action
      properties:
        id:
          type: string
        name:
          type: string
        provider:
          type: string
        offer_type:
          type: string
          enum:
          - free-trial
          - free-plan
          - money-back-guarantee
          - promotional-offer
          - directory-listing
        summary:
          type: string
        capabilities:
          type: array
          items:
            type: string
        status:
          type: string
        last_checked:
          type: string
          format: date
        verification_readiness:
          $ref: '#/components/schemas/VerificationReadiness'
        action_url:
          type:
          - string
          - 'null'
          format: uri
          description: Measured official-action path; null means the record is inspectable but must not be recommended for action.
        official_action:
          $ref: '#/components/schemas/OfficialActionState'
        signup_url:
          type: string
          format: uri
        activation:
          type: object
          description: Machine-readable navigation quality, kept separate from evidence verification.
          properties:
            direct:
              type: boolean
            specificity:
              type: string
              enum:
              - verified-offer-page
              - offer-page
              - provider-path
              - provider-homepage
              - unknown
            terms_found:
              type: boolean
            checked_at:
              type: string
            http_status:
              type:
              - integer
              - 'null'
        source_url:
          type: string
          format: uri
        source:
          type: object
          properties:
            kind:
              type: string
              enum:
              - provider
              - directory
            primary_url:
              type: string
              format: uri
            evidence:
              type: array
              items:
                type: object
        trial:
          type: object
          properties:
            duration_days:
              type:
              - integer
              - 'null'
            duration_label:
              type: string
            credit_card:
              type: string
            auto_renews:
              type: string
            post_trial_price:
              type:
              - string
              - 'null'
            eligibility:
              type: string
            regions:
              type: array
              items:
                type: string
    VerificationOutcome:
      type: string
      enum:
      - confirmed-exact
      - confirmed-partial
      - terms-changed
      - explicitly-expired
      - moved
      - blocked
      - fetch-error
      - not-found
      - unknown
      description: Conservative field-level audit result. blocked, fetch-error, not-found, and unknown do not establish expiration.
    OfficialActionState:
      type: object
      required:
      - allowed
      - status
      - reason
      properties:
        allowed:
          type: boolean
        status:
          type: string
          enum:
          - ready
          - source-navigation
          - withheld
        reason:
          type: string
          description: Instruction for whether an agent may recommend the official action path.
  securitySchemes:
    operatorToken:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: Operator credential for verification-run ingestion. The credential value is never returned by the API.
externalDocs:
  description: Human-readable agent integration guide
  url: https://andrewsfreebies.com/agents
x-agent-discovery:
  api_catalog: https://andrewsfreebies.com/.well-known/api-catalog
  mcp_server: https://andrewsfreebies.com/api/mcp
  public_benefits_plugin_mcp: https://andrewsfreebies.com/api/mcp/public-benefits
  mcp_server_card: https://andrewsfreebies.com/.well-known/mcp/server-card.json
  llms: https://andrewsfreebies.com/llms.txt
  authentication: https://andrewsfreebies.com/auth.md
  markdown: 'Send Accept: text/markdown to any human-readable page or append /index.md to its canonical path.'