{
  "openapi": "3.0.1",
  "info": {
    "title": "AI Job Search Agent — Open-Web Job Finder (BYO AI Key)",
    "description": "AI agent that scans the open web for job postings beyond any single board. Returns an LLM match score with reasoning, salary, and HTTP-verified live links. $3/1,000 results. Bring your own Anthropic or Mistral key (Mistral path ~$0.01/run).",
    "version": "0.1",
    "x-build-id": "oYkLZ77o0qEjAQWhd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nomad-agent~web-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nomad-agent-web-search-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nomad-agent~web-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-nomad-agent-web-search-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nomad-agent~web-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-nomad-agent-web-search-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "provider": {
            "title": "AI provider",
            "enum": [
              "anthropic",
              "mistral",
              "openai"
            ],
            "type": "string",
            "description": "Which AI provider runs discovery + extraction. <code>anthropic</code> (default) uses a Claude agent with Anthropic's built-in web-search tool. <code>mistral</code> uses keenable (no-auth web search) for discovery plus a Mistral model for per-page judging/extraction -- pick this if you'd rather bring a Mistral key than an Anthropic one. <code>openai</code> uses the same keenable search plus a GPT model for per-page judging/extraction -- pick this if you'd rather bring an OpenAI key.",
            "default": "anthropic"
          },
          "anthropicApiKey": {
            "title": "Anthropic API key",
            "type": "string",
            "description": "Your Anthropic API key (sk-ant-…). Required when provider is <code>anthropic</code>. The actor uses it to run a web-searching AI agent that discovers job postings. Must start with sk-ant- (an OpenAI-style sk-... key will not work here).<br><br><b>Cost note:</b> this is billed to <i>your</i> Anthropic account, on top of what Apify charges. Anthropic bills web search at <b>$10 per 1,000 searches</b> and this actor runs up to 6 searches per run (~$0.06), plus tokens — typically <b>$0.06-0.10 per run</b>. Choose <code>provider=mistral</code> for a much cheaper run: its web search (keenable) is free and only the per-page extraction uses your key."
          },
          "model": {
            "title": "Claude model",
            "enum": [
              "claude-haiku-4-5-20251001",
              "claude-sonnet-5",
              "claude-opus-4-8",
              "claude-sonnet-4-5",
              "claude-opus-4-5"
            ],
            "type": "string",
            "description": "Claude model to use for the discovery agent (provider=<code>anthropic</code> only). Haiku is fast and inexpensive and is the recommended default; switch to Sonnet 5 or Opus 4.8 for higher-quality extraction on complex pages (both cost more per run against your own key). The 4.5-era models are kept for backwards compatibility with saved tasks.",
            "default": "claude-haiku-4-5-20251001"
          },
          "mistralApiKey": {
            "title": "Mistral API key",
            "type": "string",
            "description": "Your Mistral API key. Required when provider is <code>mistral</code>. Used only for per-page judging/extraction -- the web search itself goes through keenable, which needs no key."
          },
          "mistralModel": {
            "title": "Mistral model",
            "enum": [
              "mistral-small-latest",
              "mistral-medium-latest",
              "mistral-large-latest"
            ],
            "type": "string",
            "description": "Mistral model for per-page judging/extraction (provider=<code>mistral</code> only). Medium is the default. Testing found Small matches Medium on quality for this task (extraction is small and well-scoped) at ~5x the speed -- switch to Small if you want faster/cheaper runs.",
            "default": "mistral-medium-latest"
          },
          "openaiApiKey": {
            "title": "OpenAI API key",
            "type": "string",
            "description": "Your OpenAI API key (sk-...). Required when provider is <code>openai</code>. Used only for per-page judging/extraction -- the web search itself goes through keenable, which needs no key."
          },
          "openaiModel": {
            "title": "OpenAI model",
            "type": "string",
            "description": "OpenAI model for per-page judging/extraction (provider=<code>openai</code> only). Defaults to <code>gpt-4.1-mini</code> -- cheap, fast and ample for this well-scoped extraction task. Any chat-completions model works, including the gpt-5 family (e.g. <code>gpt-5.4-mini</code>).",
            "default": "gpt-4.1-mini"
          },
          "keywords": {
            "title": "Keywords / role type",
            "type": "array",
            "description": "Role or technology keywords the agent should search for (e.g. <code>frontend</code>, <code>react</code>, <code>typescript</code>). Each entry is one keyword or short phrase.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Preferred locations",
            "type": "array",
            "description": "Preferred locations or <code>remote</code>. The agent will bias results toward these and skip obvious mismatches.",
            "items": {
              "type": "string"
            }
          },
          "remote": {
            "title": "Remote preference",
            "type": "string",
            "description": "Remote work preference communicated to the search agent. Free text — the AI agent interprets it (e.g. any, remote-only, hybrid, on-site).",
            "default": "any"
          },
          "seniority": {
            "title": "Seniority level",
            "type": "string",
            "description": "Target seniority level. The agent will prefer postings that match. Free text — the AI agent interprets it (e.g. junior, mid, senior, lead, principal — or any).",
            "default": "any"
          },
          "titleMustMatch": {
            "title": "Title must contain",
            "type": "array",
            "description": "The agent will prefer postings whose title contains at least one of these terms.",
            "items": {
              "type": "string"
            }
          },
          "titleExclude": {
            "title": "Title must NOT contain",
            "type": "array",
            "description": "The agent will skip postings whose title contains any of these terms.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum number of job postings to return (1-50; values outside that range are clamped, not rejected). The agent may return fewer if it cannot find enough high-quality matches.",
            "default": 15
          },
          "maxAgeHours": {
            "title": "Max posting age (hours)",
            "type": "integer",
            "description": "Preferred maximum age of postings in hours (default 168 = one week). The agent will prefer fresh postings but may include older ones when fresh results are scarce.",
            "default": 168
          },
          "userDescription": {
            "title": "Your own description / request (optional)",
            "type": "string",
            "description": "Free-text description of what you are looking for. The agent uses this as primary signal alongside the structured filters above — and it is also the main signal the per-posting <code>matchScore</code>/<code>matchReasoning</code> is judged against."
          },
          "onlyNewSinceLastRun": {
            "title": "Only new since last run",
            "type": "boolean",
            "description": "Delta / monitoring mode: only output postings not already seen in a previous run that also had this flag on. Already-seen postings are dropped before push (and <b>not billed</b>), so this is the cheapest way to run this Actor on a schedule and pay only for genuinely new postings. State is tracked per Actor in a dedicated key-value store, keyed by each posting's <code>id</code> (a SHA1 hash of its URL). New records carry <code>isNew: true</code>.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}