Skip to content

Geotag List

  • Endpoint Path: /api/fresns/v1/geotag/list
  • Method: GET
  • Request: Query

Headers Optional Parameter

KeyPublic Mode (Required)Private Mode (Required)
X-Fresns-Aidoptionalrequired
X-Fresns-Aid-Tokenoptionalrequired
X-Fresns-Uidoptionalrequired
X-Fresns-Uid-Tokenoptionalrequired

Query Params

KeyTypeRequiredDescription
typeNumberoptionalSpecify custom type
mapIdNumberoptionalMap Service Provider
mapLngStringoptionalMap Longitude (For querying nearby geotags)
mapLatStringoptionalMap Latitude (For querying nearby geotags)
createdDaysNumberoptionalDays created: Geotag created in the specified number of days
createdDateStringoptionalDate created: today,yesterday,week,lastWeek,month,lastMonth,year,lastYear
createdDateGtStringoptionalCreated date greater than Y-m-d
createdDateLtStringoptionalCreated date less than Y-m-d
viewCountGtNumberoptionalView count greater than
viewCountLtNumberoptionalView count less than
likeCountGtNumberoptionalLikes count greater than
likeCountLtNumberoptionalLikes count less than
dislikeCountGtNumberoptionalDislikes count greater than
dislikeCountLtNumberoptionalDislikes count less than
followCountGtNumberoptionalFollows count greater than
followCountLtNumberoptionalFollows count less than
blockCountGtNumberoptionalBlock count greater than
blockCountLtNumberoptionalBlock count less than
postCountGtNumberoptionalTotal number of posts greater than
postCountLtNumberoptionalTotal number of posts less than
postDigestCountGtNumberoptionalTotal number of digest posts greater than
postDigestCountLtNumberoptionalTotal number of digest posts less than
orderTypeStringoptionalSort by type: createdTime,lastPostTime,lastCommentTime,random,view,like,dislike,follow,block,post,postDigest
Default createdTime
orderDirectionStringoptionalSort by direction, default desc
asc,desc
filterTypeStringoptionalwhitelist only returns key-value pairs for the given key names
blacklist removes specified key-value pairs from the returned data
filterKeysStringoptionalMultiple separated by English commas, supports "dot notation" for multi-dimensional arrays
pageSizeNumberoptionalNumber of items per page (default 15 items)
pageNumberoptionalPage number (default 1)

Return

json
{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "Number / How much data in total",
            "pageSize": "Number / How much data on each page",
            "currentPage": "Number / Current page number",
            "lastPage": "Number / Last page number"
        },
        "list": [
            {
                // Common Data Structure -> Geotag Info
            }
        ]
    }
}

Released under the Apache-2.0 License