Providing access to articles

Healthily hosts a library of articles related to several different conditions that are useful as an additional resource to the user.

The articles API endpoints allows programmatic access to this library:

GET https://portal.your.md/api/v1/articles/{id} - for a single article

GET https://portal.your.md/api/v1/articles/ids={} - for multiple articles

Example request

curl --location 'https://portal.your.md/api/v1/articles?ids=migraine,con-ovulation' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Authorization: Bearer eyJraWQiOiI0Y2RmY2Q0OS1kM2QyLTRlZGMtYThlZi02MDY5ZjRmZWYwNmMiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJ5bWRNb3JzZV9ZYXZhaEp2NEZwRExkWlNSaWlSRUhIU0FEeTAzTEYyanJ4bHA5MUlxS0N2USIsImF1ZCI6IlZISSIsImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiZGV2aWNlX2lkIjoicGFydG5lcl9WSElfNzRlN2UzMDJmNmU5ZjljNzljNDA2YTJhYTA3NWQ1OTQwNzAzNTA2YTQ5MGVmZmJmMmQ2Mzk1MzcyNzgzMTVkZiIsIm5hbWUiOiJuYW1lIiwiZGVsZXRlX2F0IjoxNjc3MTY3OTE0LCJlbWFpbCI6InRlc3QxMjMtZGNlZTk4ODctYzg0NS00OTdlLTk2ZjctOGM4ODQ3ZTY3NThjQHlvdXIubWQiLCJpc3MiOiJ5bWQtaW50ZXJuYWwtc2VydmljZS1wcm9kIiwianRpIjoiOGI3ODBlZTYtZWVkZS00NDZmLTk4NGUtZTFmY2E2MWNiYWU3IiwiaWF0IjoxNjc2OTk1MTE0LCJleHAiOjE2NzY5OTY5MTR9.PGLKDj8J0Phqtg7KaCV4JfZTor3WbcNf-7OP-OajBhPCdB7M9u78_wjFMqZb6skOT3jIEM7jDKUjzmiUPJafhTxeYGkDjQtXT3Gr3-pvUtLZqCjlnljv3icDYfl4cMF6K7yXU4WVxZ_iVKw4Xd62gJ7ndE0-NJw-vCUQGBeRDsv5C4INpJnmDT0dznD88L_wFzGWbAEdU6tZBsy9KxqeKwDlEgB75h_fvCP6Ayn4_Yn8KeYA2qBOokoisNSoVZjo_F71jU2ZvtIbTwooGKRo5LCtBtS85NyA5vxciHok4kSOSix4IIbr8iIpyfmO42MCQnhKAqkPrJihmRKugmkQAw' \
--header 'x-api-key: Olq2mZfuhp4GcFHr6IUjZNUvvf93rL3lNbr59d30'

Example response - sections removed

{
    "articles": [
        {
            "id": "con-ovulation",
            "title": "Ovulation – what is it and how can you tell when you’re ovulating?",
            "snippet": "Trying for a baby? Understanding ovulation – when your body releases an egg for fertilisation – can help you get pregnant. Here’s what you need to know.",
            "reading_time_minutes": 6,
            "paragraphs": [
                {
                    "title": "Overview",
                    "content": "Ovulation happens as part of your monthly menstrual cycle. It's when 1 of your ovaries releases an egg and if this egg is fertilised by sperm, you can become pregnant. \n\nOnce your periods start during puberty, you’ll usually release an egg (ovulate) about once a month until you reach the menopause – when your periods stop and you’re no longer able to get pregnant.\n\nUnderstanding more about ovulation, and the signs to look out for, can be helpful if you’re trying for a baby. Read on to learn more."
                }
            ],
            "target_images": {
                "header": "https://images.ctfassets.net/iqo3fk8od6t9/786eNNIBcCMTrkKdY5IczX/761fd8a392f6e147a1dfcc94fcf3f41a/Ovulation.png",
                "topic": "https://images.ctfassets.net/iqo3fk8od6t9/2GzemRR1nVehe1HSznuLtP/c0faaa09d73fc22d6d0e027a90a20cec/Ovulation.jpg",
                "category": "https://images.ctfassets.net/iqo3fk8od6t9/28DRNEfselXRYAL9OwoaBq/9f4d8fb075077562a59168e645326d95/Womens-health-min.jpg"
            },
            "authors": [
                {
                    "name": "Joana Doe",
                    "job_title": "Digital sub-editor",
                    "bio": "Joana Doe is a journalist and editor with 20 years' experience, much of it working for medical magazines.",
                    "team": "Contributors",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "editors": [
                {
                    "name": "Joana Doe",
                    "job_title": "Former contributor",
                    "bio": "Joana Doe has been sub-editing and writing for magazines, websites and major brands, such as Boots and Marks & Spencer, for more than 17 years, and has a particular passion for health-related content.",
                    "team": "Contributors",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "reviewers": [
                {
                    "name": "Dr Joana Doe",
                    "job_title": "Clinical content reviewer, MBBS BSc (Hons) DTMH DFSRH MRCGP",
                    "bio": "Joana Doe is a qualified general practitioner (GP; family doctor) with interests in tropical and travel medicine, family planning and sexual health.",
                    "team": "Medical team",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "references": "Ovulation: Frequently Asked Questions [Internet]. American Pregnancy Association. 2021 [cited 15 November 2021]. Available [here](https://americanpregnancy.org/getting-pregnant/ovulation-faqs)\n\n",
            "published_date": "2022-01-06",
            "reviewed_date": "2022-01-06",
            "next_review_date": "2025-01-06"
        },
        {
            "id": "migraine",
            "title": "Migraine – how to manage it",
            "snippet": "A migraine usually means you feel bad head pain on 1 side, sometimes with other symptoms such as nausea (feeling sick). Discover types and triggers, plus when to see a doctor.",
            "reading_time_minutes": 6,
            "paragraphs": [
                {
                    "content": "A migraine usually means you feel bad head pain on 1 side, sometimes with other symptoms such as nausea (feeling sick), or seeing flashing lights (aura). You can get migraines several times a week or every now and then. Pain and symptoms can be so bad they can stop you going about your day. Find out how to get relief and manage your migraine."
                }
            ],
            "target_images": {
                "header": "https://images.ctfassets.net/iqo3fk8od6t9/4Ej7uM4x17y3lGdw2MeMir/45cc352bd90b614ab08fe859a9b19f53/iStock-1275798938.jpg",
                "topic": "https://images.ctfassets.net/iqo3fk8od6t9/1Y2pB8dOqQW0gfoTrmA5XR/8c902260e89f285c918f8ba27c4b849e/African_woman_sitting_on_couch_feels_unhappy_having_problems.jpg",
                "category": "https://images.ctfassets.net/iqo3fk8od6t9/4TUrRI22qxOzHwVfnhf6vw/0c879a5f82bfc39cb898d5070c97af5f/Brain-and-nervous-system-min.jpg"
            },
            "authors": [
                {
                    "name": "Joana Doe",
                    "job_title": "Digital sub-editor",
                    "bio": "Joana Doe is a journalist and editor with 20 years' experience, much of it working for medical magazines.",
                    "team": "Contributors",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "editors": [
                {
                    "name": "Joana Doe",
                    "job_title": "Former contributor",
                    "bio": "Joana Doe has been sub-editing and writing for magazines, websites and major brands, such as Boots and Marks & Spencer, for more than 17 years, and has a particular passion for health-related content.",
                    "team": "Contributors",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "reviewers": [
                {
                    "name": "Dr Joana Doe",
                    "job_title": "Clinical content reviewer, MBBS BSc (Hons) DTMH DFSRH MRCGP",
                    "bio": "Joana Doe is a qualified general practitioner (GP; family doctor) with interests in tropical and travel medicine, family planning and sexual health.",
                    "team": "Medical team",
                    "photo_url": "https://images.ctfassets.net/iqo3fk8od6t9/5JCWmZ9GOUGBb7S6fhQS2M/8b969dec63f8458a9c98e9e847e6e13b/dummy.png"
                }
            ],
            "references": "Headache disorders: How common are headaches? [Internet]. www.who.int. 2014. Available from: https://www.who.int/news-room/questions-and-answers/item/headache-disorders-how-common-are-headaches\n\nWhat is migraine? [Internet]. The Migraine Trust. Available from: https://migrainetrust.org/understand-migraine/what-is-migraine/#page-section-1\n\n",
            "published_date": "2025-09-10",
            "reviewed_date": "2025-09-10",
            "next_review_date": "2028-09-09"
        }
    ]
}