# Get a list of stores

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface English name: newgetpoilist

This interface is used to obtain store lists

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/wxa/get_store_list?access_token=ACCESS_TOKEN

# Cloud Calls

  • This interface does not support cloud calls

# Third party invocation

  • This interface supports Third Party Platform generation business call.

  • This interface belongs to the permission set id: 8-10,13

  • When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parametersQuery String parameters

Parameter NametypeRequired to fill inIntroductions
access_tokenstringyesInterface invocation credentials, using access_token , authorizer_access_token

# Request BodyRequest Payload

Parameter NametypeRequired to fill inIntroductions
offsetnumberyesGet the initial shift location of the store list, count from 0
limitnumberyesNumber of stores obtained

# 3. Return Parameters

# Response Payload

Parameter NametypeIntroductions
errcodenumberError code
errmsgstringError Description
business_listobjarrayList of stores
total_countnumberTotal number of stores

# Res.business_list(Array)Object Payload

List of stores

Parameter NametypeIntroductions
poi_idstringStore ID
business_namestringStore Name
longitudestringlongitude
latitudestringlatitude
provincestringprovince
citystringcity
districtstringarea
addressstringDetailed address
telephonestringPhone numbers, which may be multiple, using the English divisional spacing of 010-666666-111; 010-6666666; 010- 6666666-222
photo_listobjarrayList of store photos
qualification_namestringName of business license
qualification_numstringBusiness license number
open_timestringStore opening hours
statusnumberAudit results, 1- Audit passed, 2- Audit in progress, 3- Audit failed

# Res.business_list(Array).photo_listObject Payload

List of store photos

Parameter NametypeIntroductions
photo_urlstringImage url

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

{
  "offset": 0,
  "limit": 10
}

Return an example

{
    "errcode": 0,
    "errmsg": "ok",
    "business_list": [
        {
            "base_info": {
                "business_name": "超速天使俱乐部",
                "address": "新华路19",
                "telephone": "12345678",
                "categories": [],
                "city": "邯郸市",
                "province": "河北省",
                "longitude": 114.958480835,
                "latitude": 36.7714881897,
                "photo_list": [
                    {
                        "photo_url": "http://mmbiz.qpic.cn/mmbiz_jpg/tW66AWvE2K4e52sLYyA90ZKuicdfhkf5ibQk1icmcRWjrMxmVibo8sVQAllABxG5ic0D5x62gfsPVL4aibxQ2SicfPyjQ/0?wx_fmt=jpeg"
                    }
                ],
                "open_time": "10:00-21:00",
                "poi_id": "472665875",
                "status": 1,
                "district": "曲周县",
                "qualification_list": [],
                "qualification_num": "01650100NE2XCT6Z70",
                "qualification_name": "超速天使俱乐部"
            }
        },
        {
            "base_info": {
                "business_name": "龙涤小区熟食店",
                "address": "舍利街道中都大道龙涤小区阿升电脑旁",
                "telephone": "12345678",
                "categories": [],
                "city": "哈尔滨市",
                "province": "黑龙江省",
                "longitude": 126.94355011,
                "latitude": 45.556098938,
                "photo_list": [
                    {
                        "photo_url": "http://mmbiz.qpic.cn/mmbiz_png/tW66AWvE2K6icjle1q6nbfKr0HMibzxKqOUfG1hARktHV84ZZojt9cXZ0UicDevZQUicckPw68lfo2Le3RjpEo6oLg/0?wx_fmt=png"
                    }
                ],
                "open_time": "11:00-12:00",
                "poi_id": "472671857",
                "status": 3,
                "district": "阿城区",
                "qualification_list": [],
                "qualification_num": "91750100ME2XCR6A70",
                "qualification_name": "龙涤小区熟食店"
            }
        }
    ],
    "total_count": 2
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error codeError DescriptionSolutions
40001invalid credential  access_token isinvalid or not latestAppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account

# 7. Scope of application

How this interface can be invoked under different account types:
Official Account Service Account
  • ✔: The account can call this interface
  • Other account types that are not expressly stated may not be called on this interface without special instructions;