Perq

Answer "what free credits / free tier / startup program can I get for X". Ranked, verified offers matching a need such as "free speech to text credits", "GPU for a bootstrapped startup" or "student LLM API credits". Each result has credit_value, eligibility, how_to_claim, claim_url, source_url, source_snippet (verbatim vendor quote), last_verified, value_usd (explicit one-time USD amount or null), audience, and live claims / claims_7d / votes counts (real visitors, never padded; null if unavailable). filters.sort orders by relevance (default), popular (most claimed this week), votes, newest, verified (most recently re-checked), value (largest stated USD credit) or az. need may be empty when you only filter/sort. Closed offers are excluded unless filters.status is "all"/"closed" or include_closed is true. claim_redirect_url sends the user to the vendor and counts the claim anonymously; claim_url is the direct vendor link.

{
  "type": "object",
  "properties": {
    "need": {
      "type": "string",
      "description": "What the user wants credits for, in plain words. E.g. \"speech to text\", \"GPU compute for a bootstrapped startup\", \"vector database\". May be empty (\"\") to list by filters and sort only."
    },
    "filters": {
      "type": "object",
      "description": "Optional filters.",
      "properties": {
        "category": {
          "type": "string",
          "description": "Category slug: cloud-gpu, llm-api, agents-automation, observability, voice-audio, dev-tools, perk-marketplace, database-backend, vector-db, image-video, productivity, accelerator."
        },
        "type": {
          "type": "string",
          "description": "Offer type slug: startup-program, free-tier, signup-credit, student-education, marketplace-perk, promo-code, accelerator-perk."
        },
        "student": {
          "type": "boolean",
          "description": "Only offers for students, educators or researchers."
        },
        "no_application": {
          "type": "boolean",
          "description": "Only offers you can use right after signup (free tiers, signup credits, promo codes); no application or approval."
        },
        "include_closed": {
          "type": "boolean",
          "description": "Include offers that have closed (default false)."
        },
        "status": {
          "type": "string",
          "enum": [
            "live",
            "closed",
            "all"
          ],
          "description": "live (default), closed, or all."
        },
        "audience": {
          "type": "string",
          "description": "Who can claim: startup, student, anyone, members (members = customers of a bank/marketplace partner). Comma-separate to require several."
        },
        "min_value": {
          "type": "number",
          "description": "Only offers whose credit_value leads with an explicit one-time USD amount of at least this much (e.g. 10000)."
        },
        "sort": {
          "type": "string",
          "enum": [
            "relevance",
            "popular",
            "votes",
            "newest",
            "verified",
            "value",
            "az"
          ],
          "description": "relevance (default), popular, votes, newest, verified, value, az."
        },
        "limit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 50,
          "description": "Max results (default 10)."
        }
      },
      "additionalProperties": false
    }
  }
}

Offers people are actually claiming (clicks on the claim link, one per visitor per day) or voting "worked for me", over the last 7 days or all time. Counts are real and never seeded; when nothing has been claimed yet the list is empty and says so.

{
  "type": "object",
  "properties": {
    "by": {
      "type": "string",
      "enum": [
        "claims",
        "votes"
      ],
      "description": "claims (default) or votes."
    },
    "window": {
      "type": "string",
      "enum": [
        "7d",
        "all"
      ],
      "description": "7d (default) or all."
    },
    "category": {
      "type": "string",
      "description": "Optional category slug, e.g. llm-api."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 10)."
    }
  }
}

Full record for one Perq offer by id (e.g. "deepgram-200-credit"), including source quote, last_verified, recorded changes and packs that contain it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Offer id from find_credits or a pack."
    }
  },
  "required": [
    "id"
  ]
}

Curated bundles of offers (e.g. AI startup launch pack, LLM API free tier pack, voice AI pack) with each pack's headline and up-to total where one is computed.

{
  "type": "object",
  "properties": {}
}

One curated pack by slug with every offer in it and how its up-to total was computed (which offers counted and why others did not).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Pack slug from list_packs, e.g. \"llm-api-free-tier-pack\"."
    }
  },
  "required": [
    "slug"
  ]
}

Offers added, updated (value, eligibility, claim steps) or closed in the last N days (dates in America/New_York).

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Look-back window in days (default 7)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Max events returned (default 100)."
    }
  }
}

Get newly verified offers before they are public on https://perq.sh (about 24h early), plus closures and changes. Give either email (a person: we send a confirmation link, then a digest only on days with something new) or webhook_url (an agent: https only, public hosts only; each new offer is POSTed as JSON signed with HMAC-SHA256). A webhook signup returns the signing secret once, a private feed token for early_offers, and the result of a signed verification ping. Only subscribe an address or URL the user asked you to.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to subscribe (double opt-in)."
    },
    "webhook_url": {
      "type": "string",
      "description": "https:// URL that receives signed JSON POSTs."
    },
    "topics": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "llm-api",
          "gpu",
          "voice",
          "startup-programs",
          "student",
          "agents",
          "dev-tools"
        ]
      },
      "description": "Optional topics; omit for everything. One of: llm-api, gpu, voice, startup-programs, student, agents, dev-tools."
    }
  }
}

Offers that are verified but not public yet (embargoed, each with public_after), plus new, changed and closed offer events from the last 30 days, filtered by the subscription topics. Needs the private feed token from subscribe (webhook) or from the email confirmation page.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Private feed token (starts with pf_)."
    }
  },
  "required": [
    "token"
  ]
}