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/hookdetector-com:hookdetector-com-jobs-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Hook Detector Jobs API
  description: 'Find short-form hooks that already work.


    Sign up with a beta access code (ask at https://hookdetector.com/access): one POST to

    `/v1/accounts` with `access_code` gives an API key and free credits. The same operations are available as MCP tools at `/mcp`.


    Full guide, always current, at `/llms.txt`.'
  contact:
    name: Hook Detector
    url: https://hookdetector.com/
    email: contact@hookdetector.com
  version: 3.0.0
tags:
- name: Jobs
paths:
  /v1/jobs:
    post:
      tags:
      - Jobs
      summary: Start a background job (echo)
      description: 'Start a job that runs in the background on Hook Detector''s job runner, the same

        runner that refreshes trackers, alerts and snapshots. Only `echo` can be started by

        hand: it waits `seconds` (1 to 120) and answers `message` back with how many attempts it

        took, a free way to watch the runner (a job survives a deploy). At most 3 an hour per

        account (429). Free. Read it back with GET /v1/jobs/{job_id}. MCP: start_job.'
      operationId: start_job_v1_jobs_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
          title: Authorization
        description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JobIn'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobOut'
        '401':
          description: missing, invalid, revoked or expired API key (code key_expired)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '403':
          description: the key lacks the scope this call needs (insufficient_scope), or its credit_limit is spent (key_credit_limit_reached)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '413':
          description: request body over the size cap
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '429':
          description: rate limited; see Retry-After
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '500':
          description: our fault; names the request id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
    get:
      tags:
      - Jobs
      summary: This account's background jobs, newest first
      description: 'Every background job this account started or that runs for it (tracker refreshes,

        alerts, reviews, echo), newest first: kind, status, attempts, credits spent, result or

        error, and why a waiting job waits. Free. MCP: list_jobs.'
      operationId: list_jobs_v1_jobs_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: how many, 1 to 100
          default: 50
          title: Limit
        description: how many, 1 to 100
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
          title: Authorization
        description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobList'
        '401':
          description: missing, invalid, revoked or expired API key (code key_expired)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '403':
          description: the key lacks the scope this call needs (insufficient_scope), or its credit_limit is spent (key_credit_limit_reached)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '413':
          description: request body over the size cap
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '500':
          description: our fault; names the request id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
  /v1/jobs/{job_id}:
    get:
      tags:
      - Jobs
      summary: One background job
      description: 'One background job of this account with its status, attempts, result or error.

        A job of another account, or one the system runs for nobody, is 404 job_not_found.

        Free. MCP: get_job.'
      operationId: get_job_v1_jobs__job_id__get
      parameters:
      - name: job_id
        in: path
        required: true
        schema:
          type: string
          title: Job Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
          title: Authorization
        description: Bearer hd_... from POST /v1/accounts or POST /v1/keys
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobOut'
        '401':
          description: missing, invalid, revoked or expired API key (code key_expired)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '403':
          description: the key lacks the scope this call needs (insufficient_scope), or its credit_limit is spent (key_credit_limit_reached)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '404':
          description: not found on this account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '413':
          description: request body over the size cap
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '422':
          description: invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
        '500':
          description: our fault; names the request id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorOut'
components:
  schemas:
    JobOut:
      properties:
        job_id:
          type: string
          title: Job Id
        kind:
          type: string
          title: Kind
        status:
          type: string
          title: Status
          description: queued, running, done, failed or cancelled
        payload:
          additionalProperties: true
          type: object
          title: Payload
        result:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Result
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
          description: the last failure, short; a retried job keeps it until it succeeds
        note:
          anyOf:
          - type: string
          - type: 'null'
          title: Note
          description: 'why a job is waiting: handed back when its process stopped, or its kind''s daily cap'
        attempts:
          type: integer
          title: Attempts
        max_attempts:
          type: integer
          title: Max Attempts
        credits:
          type: integer
          title: Credits
          description: provider credits this job spent (an echo job, 0)
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        run_after:
          anyOf:
          - type: string
          - type: 'null'
          title: Run After
        started_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Started At
        finished_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Finished At
      additionalProperties: true
      type: object
      required:
      - job_id
      - kind
      - status
      - payload
      - attempts
      - max_attempts
      - credits
      title: JobOut
      examples:
      - attempts: 1
        created_at: '2026-10-26T13:00:00+00:00'
        credits: 0
        finished_at: '2026-10-26T13:00:06+00:00'
        job_id: 7b0f1c9e-1d2a-4f00-9c1e-2b9f6d1a0c11
        kind: echo
        max_attempts: 4
        payload:
          message: hello
          seconds: 5
        result:
          attempts: 1
          echo: hello
          slept_s: 5
        run_after: '2026-10-26T13:00:00+00:00'
        started_at: '2026-10-26T13:00:01+00:00'
        status: done
    ErrorOut:
      properties:
        detail:
          type: string
          title: Detail
          description: one sentence a person can read
        code:
          type: string
          title: Code
          description: stable machine code; see the Errors section of /llms.txt
        errors:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          title: Errors
          description: 'on a 422 only: the field level list'
      additionalProperties: true
      type: object
      required:
      - detail
      - code
      title: ErrorOut
      examples:
      - code: run_not_found
        detail: no such run for this account
    JobIn:
      properties:
        kind:
          type: string
          const: echo
          title: Kind
          description: 'the kind of job to start; only echo today: it waits `seconds` and answers what it was sent'
        seconds:
          type: integer
          maximum: 120.0
          minimum: 1.0
          title: Seconds
          description: how long the echo job waits, 1 to 120
          default: 5
        message:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Message
          description: text the job echoes back
      type: object
      required:
      - kind
      title: JobIn
    JobList:
      properties:
        jobs:
          items:
            $ref: '#/components/schemas/JobOut'
          type: array
          title: Jobs
      additionalProperties: true
      type: object
      required:
      - jobs
      title: JobList
      examples:
      - jobs:
        - attempts: 1
          created_at: '2026-10-26T13:00:00+00:00'
          credits: 0
          finished_at: '2026-10-26T13:00:06+00:00'
          job_id: 7b0f1c9e-1d2a-4f00-9c1e-2b9f6d1a0c11
          kind: echo
          max_attempts: 4
          payload:
            message: hello
            seconds: 5
          result:
            attempts: 1
            echo: hello
            slept_s: 5
          run_after: '2026-10-26T13:00:00+00:00'
          started_at: '2026-10-26T13:00:01+00:00'
          status: done