API Search Endpoint

This document provides details about the endpoints used in the Funbooker Search API.

POST - Execute search Listing action.

• Endpoint: POST /api/partner/v1/search

• Description: This endpoint retrieves a list of listings with optional parameters.

• Request body (required):

  • The SearchRequest

    • exemple:

    {
      "query": "Skydiving",
      "radius": 50000,
      "categories": [
        1
      ],
      "lat": null,
      "lng": null,
      "hitsPerPage": 30,
      "page": 1,
      "minY": 48.816314210034,
      "maxY": 48.902007785215,
      "minX": 2.2242191058804,
      "maxX": 2.4675819883673
    }

• Response Example:

{
  "hits": [
    {
      "id": 1084999051,
      "type": "birthday",
      "user": [
        {
          "name": "Jennifer et ses comédiens",
          "average_offerer_rating": 5
        }
      ],
      "_geoloc": {
        "lat": 45.5582613,
        "lng": 5.385548,
        "department_code": "38",
        "city": "Cessieu",
        "zip": "38110"
      },
      "categories": [
        [
          {
            "root": 208,
            "parent": 470,
            "id": 478,
            "name": "Anniversaire Miraculous",
            "short_name": "Miraculous",
            "occasion": "birthday",
            "lvl": 3,
            "isLeaf": true
          },
          {
            "root": 208,
            "parent": 208,
            "id": 470,
            "name": "Anniversaire Film & Héros",
            "short_name": "Film & Héros",
            "occasion": "birthday",
            "lvl": 2,
            "isLeaf": false
          },
          {
            "root": 208,
            "parent": null,
            "id": 208,
            "name": "Anniversaire Enfant",
            "short_name": "Tous les anniversaires enfant",
            "occasion": "birthday",
            "lvl": 1,
            "isLeaf": false
          }
        ]
      ],
      "averageRating": 5,
      "commentCount": 30,
      "minAge": 3,
      "maxAge": 12,
      "home": true,
      "user_picture": "marketplace-user/lraww5qil7gnzvhh71ft",
      "title": "Anniversaire Miraculous Ladybug 3-12 ans à domicile (IDF)",
      "teaser": "Votre enfant est fan de Ladybug et du chat noir ? Jennifer et son équipe de comédiens se déplacent à votre domicile pour une fête d'anniversaire thématisée autour de Miraculous Ladybug !",
      "priceFrom": "12 enfants",
      "slug": "anniversaire-miraculous-ladybug-3-12-ans-a-domicile-idf",
      "status": 2,
      "price": 140,
      "departments": [
        9055053,
        9055055,
        9055056
      ],
      "image_name": "marketplace-listing/ldfvpotgi05vg6mbpwul",
      "duration": {
        "hours": 1,
        "minutes": 30,
        "real_time": 90
      },
      "sort_scoring": 78,
      "onDiscount": null,
      "objectID": "1084999051",
      "videoUrl": null
    }
  ],
  "nbHits": 12,
  "page": 1,
  "nbPages": 3,
  "hitsPerPage": 5,
  "query": "Miraculous",
  "pagination": [
    {
      "pages_count": 5,
      "page": 1
    }
  ]
}