search

Describe Your Search (natural language)

Turn a free-text description of the job search the user wants into a structured search configuration. Stateless - nothing is persisted; the caller applies the returned config.

post/search/describe

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/search/describe
  • Auth: HTTP bearer

Request body

messagestring required

Natural-language description of the job search the user wants.

Example request

{
  "message": "Remote senior backend roles in the US paying at least $180k",
  "priorConfig": {
    "workStyles": [
      "remote"
    ],
    "experienceLevels": [
      "mid"
    ],
    "visaSponsorship": "any",
    "presetId": "balanced",
    "coverLetterStrategy": "generate_new",
    "resumeStrategy": "tailor"
  },
  "currentConfig": {
    "workStyles": [
      "remote"
    ],
    "experienceLevels": [
      "mid"
    ],
    "visaSponsorship": "any",
    "presetId": "balanced",
    "coverLetterStrategy": "generate_new",
    "resumeStrategy": "tailor"
  }
}

Response

Structured search config derived from the message

successtrue required

Example response

{
  "data": {
    "scope": "edit",
    "config": {
      "workStyles": [
        "remote"
      ],
      "experienceLevels": [
        "mid"
      ],
      "visaSponsorship": "any",
      "presetId": "balanced",
      "coverLetterStrategy": "generate_new",
      "resumeStrategy": "tailor"
    }
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.