# searchHasPublications

**Identifier:** `has_searchHasPublications`

**Provider:** [HAS - Haute Autorité de Santé](https://kirha.com/providers/has.md)

Search publications of the French Haute Autorité de Santé (HAS) by free text, publication type, indexing category and publication date. Use the returned 'ids' with getHasPublication for full structured data. The search AND-matches every word of the query: keep it to 2-4 core French disease/drug/procedure terms and never include author names, years, PMIDs or boolean operators, otherwise it returns 0 results. Translate medical/MeSH terms to French. Provide at least one of query, publicationTypes or categoryIds.

## Run it with the CLI

```bash
kirha tools run has_searchHasPublications \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "has_searchHasPublications",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "categoryIds": {
      "description": "HAS category ids (e.g. c_64678) from getHasPublication or getHasCategories, used as facets",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "categoryMatch": {
      "default": "any",
      "enum": [
        "any",
        "all"
      ],
      "type": "string"
    },
    "language": {
      "default": "fr",
      "enum": [
        "fr",
        "en"
      ],
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "number"
    },
    "offset": {
      "default": 0,
      "minimum": 0,
      "type": "number"
    },
    "publicationTypes": {
      "description": "PNDS, national diagnosis-and-care protocols and clinical care guidelines are clinicalGuideline (NOT professionalRecommendation). Filtering AND-restricts results and HAS files similar content under different categories, so when unsure omit this and rely on the text query.",
      "items": {
        "enum": [
          "medicationOpinion",
          "medicalDeviceOpinion",
          "professionalRecommendation",
          "clinicalGuideline",
          "patientGuide",
          "healthTechnologyAssessment",
          "opinionAndDecision",
          "programPolicyEvaluation",
          "studyAndSurvey",
          "pressRelease",
          "article"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "publishedAfter": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "publishedBefore": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "query": {
      "description": "2-4 core French terms, all must match (e.g. 'PNDS angioedème héréditaire')",
      "type": "string"
    },
    "sortBy": {
      "default": "relevance",
      "enum": [
        "relevance",
        "newest",
        "oldest"
      ],
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "ids": {
      "description": "HAS publication ids for use with getHasPublication",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "publications": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "categoryIds": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "id": {
            "type": "string"
          },
          "publishedAt": {
            "type": "string"
          },
          "summary": {
            "description": "First 500 characters; full text via getHasPublication",
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "type",
          "title",
          "url"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "publications",
    "total",
    "ids"
  ],
  "type": "object"
}
```

## Related tools

Other HAS - Haute Autorité de Santé tools that this tool refers to, or that refer to it.

- [`getHasPublication`](https://kirha.com/providers/has/getHasPublication.md)
- [`getHasCategories`](https://kirha.com/providers/has/getHasCategories.md)

-----

[All HAS - Haute Autorité de Santé tools](https://kirha.com/providers/has.md) · [< Back to tools list](https://kirha.com/tools.md)