Location Search Locations

این اندپوینت به شما امکان می‌دهد تا لوکیشن‌های اینستاگرام را بر اساس یک عبارتی که وارد می‌کنید (نام مکان یا کلمه کلیدی) جستجو کنید. این قابلیت برای یافتن مکان‌هایی که نامشان حاوی متن مورد نظر است یا مرتبط با عبارت جستجو است بسیار مفید است.

پارامتر ورودی:

query (الزامی): عبارت جستجو برای نام لوکیشن یا بخشی از آن.

خروجی: پاسخ JSON شامل لیستی از لوکیشن‌ها است. هر لوکیشن ممکن است شامل فیلدهای زیر باشد:

id: شناسهٔ عددی لوکیشن
name: نام لوکیشن
slug: رشتهٔ راحت برای آدرس (URL-friendly name) لوکیشن
address: آدرس کامل لوکیشن
city: شهری که لوکیشن در آن واقع است
latitude: عرض جغرافیایی لوکیشن
longitude: طول جغرافیایی لوکیشن
media_count: تعداد محتواهای مرتبط با آن لوکیشن (اگر موجود باشد)

Name	Type	Default	Description
query (required)	string	–	The search query

curl --request POST \
--url https://boxapi.ir/api/instagram/location/search \
--user 'boxapi_username:boxapi_password' \
--data '{
        "query": "seoul"
    }'

                    {
    "status": "done",
    "response": {
        "status_code": 200,
        "content_type": "application/json",
        "body": {
            "num_results": 20,
            "locations": [
                {
                    "pk": 213094191,
                    "short_name": "Seoul",
                    "facebook_places_id": 108259475871818,
                    "external_source": "facebook_places",
                    "name": "Seoul, Korea",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.01648,
                    "lat": 37.51502
                },
                {
                    "pk": 103179741437964,
                    "short_name": "Seoul",
                    "facebook_places_id": 103179741437964,
                    "external_source": "facebook_places",
                    "name": "Seoul",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.01648,
                    "lat": 37.51502
                },
                {
                    "pk": 114618953610164,
                    "short_name": "Seoul",
                    "facebook_places_id": 114618953610164,
                    "external_source": "facebook_places",
                    "name": "Seoul, South Korea",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.83096312586,
                    "lat": 37.531483429932
                },
                {
                    "pk": 111345614120957,
                    "short_name": "Seoul",
                    "facebook_places_id": 111345614120957,
                    "external_source": "facebook_places",
                    "name": "Seoul",
                    "address": "\uc5ec\uc758\ub3c4",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.01648,
                    "lat": 37.51502
                },
                {
                    "pk": 626328896,
                    "short_name": "\uc11c\uc6b8 - Seoul",
                    "facebook_places_id": 121961044613621,
                    "external_source": "facebook_places",
                    "name": "\uc11c\uc6b8 - Seoul",
                    "address": "Seoul, South Korea",
                    "city": "Seoul, Korea",
                    "has_viewer_saved": false,
                    "lng": 126.44268035889,
                    "lat": 37.463686064597
                },
                {
                    "pk": 1033039811,
                    "short_name": "Seoul National University",
                    "facebook_places_id": 468973106547809,
                    "external_source": "facebook_places",
                    "name": "Seoul National University",
                    "address": "\uad00\uc545\uad6c \uad00\uc545\ub85c 1",
                    "city": "Seoul, Korea",
                    "has_viewer_saved": false,
                    "lng": 126.95296740722,
                    "lat": 37.458471713252
                },
                {
                    "pk": 497665115,
                    "short_name": "Hongdae",
                    "facebook_places_id": 107754709258916,
                    "external_source": "facebook_places",
                    "name": "Hongdae, Seoul",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.926216667,
                    "lat": 37.5518916667
                },
                {
                    "pk": 6281703,
                    "short_name": "Seoul Station",
                    "facebook_places_id": 112170862134265,
                    "external_source": "facebook_places",
                    "name": "Seoul Station",
                    "address": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc \uc6a9\uc0b0\uad6c \ub3d9\uc790\ub3d9 43-205",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.97083333333,
                    "lat": 37.554722222222
                },
                {
                    "pk": 163508023803553,
                    "short_name": "Seoul South Korea",
                    "facebook_places_id": 163508023803553,
                    "external_source": "facebook_places",
                    "name": "Seoul South Korea",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 122.54299422363,
                    "lat": 10.684287425245
                },
                {
                    "pk": 214198432,
                    "short_name": "Seoul World Cup Stadium",
                    "facebook_places_id": 137128652983342,
                    "external_source": "facebook_places",
                    "name": "Seoul World Cup Stadium",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.8972462982,
                    "lat": 37.568937541
                },
                {
                    "pk": 101291802018061,
                    "short_name": "Seoul",
                    "facebook_places_id": 101291802018061,
                    "external_source": "facebook_places",
                    "name": "Seoul",
                    "address": "Seoul",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.01648,
                    "lat": 37.51502
                },
                {
                    "pk": 111045712250933,
                    "short_name": "Soul of Asia",
                    "facebook_places_id": 111045712250933,
                    "external_source": "facebook_places",
                    "name": "Soul of Asia",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.97796944444,
                    "lat": 37.566536111111
                },
                {
                    "pk": 213123677,
                    "short_name": "N Seoul Tower",
                    "facebook_places_id": 107554759273687,
                    "external_source": "facebook_places",
                    "name": "N Seoul Tower",
                    "address": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc \uc6a9\uc0b0\uad6c \uc6a9\uc0b0\ub3d92\uac00 \uc0b01-3",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.988,
                    "lat": 37.551425
                },
                {
                    "pk": 376591198,
                    "short_name": "Seoul Olympic Stadium",
                    "facebook_places_id": 132886263418478,
                    "external_source": "facebook_places",
                    "name": "Seoul Olympic Stadium",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.07590460271,
                    "lat": 37.515884244695
                },
                {
                    "pk": 737692104,
                    "short_name": "Seoul",
                    "facebook_places_id": 228050583932191,
                    "external_source": "facebook_places",
                    "name": "Seoul, Korea Selatan",
                    "address": "Namyung",
                    "city": "Seoul, Korea",
                    "has_viewer_saved": false,
                    "lng": 106.44903993169,
                    "lat": -6.1977899980345
                },
                {
                    "pk": 1022583626,
                    "short_name": "Seoul Gangnam \uac15\ub0a8\ud398\uc2a4\ud2f0\ubc8c",
                    "facebook_places_id": 258228837630159,
                    "external_source": "facebook_places",
                    "name": "Seoul Gangnam \uac15\ub0a8\ud398\uc2a4\ud2f0\ubc8c",
                    "address": "",
                    "city": "Seoul, Korea",
                    "has_viewer_saved": false,
                    "lng": 126.99215,
                    "lat": 37.543713
                },
                {
                    "pk": 102184738595191,
                    "short_name": "The Hyundai Seoul",
                    "facebook_places_id": 102184738595191,
                    "external_source": "facebook_places",
                    "name": "The Hyundai Seoul",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.9281938,
                    "lat": 37.5263423
                },
                {
                    "pk": 214710130,
                    "short_name": "Olympic Park",
                    "facebook_places_id": 105585482807895,
                    "external_source": "facebook_places",
                    "name": "Olympic Park, Seoul",
                    "address": "\uc11c\uc6b8\ud2b9\ubcc4\uc2dc \uc1a1\ud30c\uad6c \ubc29\uc774\ub3d9 88",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 127.122674,
                    "lat": 37.520789
                },
                {
                    "pk": 230094983,
                    "short_name": "Mapo",
                    "facebook_places_id": 420070264712856,
                    "external_source": "facebook_places",
                    "name": "Mapo, Seoul, Korea",
                    "address": "",
                    "city": "",
                    "has_viewer_saved": false,
                    "lng": 126.94887625121,
                    "lat": 37.541486590549
                },
                {
                    "pk": 1834902660100627,
                    "short_name": "\uc11c\uc6b8\uc2a4\uce74\uc774 Seoul Sky",
                    "facebook_places_id": 1834902660100627,
                    "external_source": "facebook_places",
                    "name": "\uc11c\uc6b8\uc2a4\uce74\uc774 Seoul Sky, Lotte World Tower, Korea",
                    "address": "\uc1a1\ud30c\uad6c \uc62c\ub9bc\ud53d\ub85c 300 123\uce35",
                    "city": "\uc11c\uc6b8",
                    "has_viewer_saved": false,
                    "lng": 127.10219065969,
                    "lat": 37.512609926213
                }
            ],
            "status": "ok"
        }
    }
}