{
  "openapi": "3.0.1",
  "info": {
    "title": "Tencent Scraper | Maps Places, Phones and Ratings",
    "description": "Tencent Maps scraper (腾讯地图, QQ地图) for Chinese businesses: 100 places in 4 seconds, 48 fields each. Get name, category, address, phones, rating, average spend, opening hours, coordinates and Dianping, Amap, Meituan and Ctrip ids, plus photos, menus and reviews. Search in English or Chinese. No login.",
    "version": "1.0",
    "x-build-id": "yWOnZApteC5ZbZkyU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~tencent-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-tencent-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/silentflow~tencent-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-tencent-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/silentflow~tencent-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-tencent-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "🔎 Search terms",
            "type": "array",
            "description": "What to look for, in English or Chinese: <code>hotpot</code>, <code>coffee</code>, <code>酒店</code>, <code>海底捞</code>. Category words return the most places; a brand name returns the branches the map features. A place found by several terms or in several cities is saved once.",
            "items": {
              "type": "string"
            }
          },
          "cities": {
            "title": "📍 Cities",
            "type": "array",
            "description": "Where to search: a city or a province, in English or Chinese (<code>Shanghai</code>, <code>上海</code>, <code>Sichuan</code>). Each search term runs in each city. Leave empty to search all of China, busiest cities first.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max places per search",
            "minimum": 1,
            "type": "integer",
            "description": "Stop each search (one term in one city) after this many places. When a city lists more places than one search shows (about 800), the search goes on district by district to reach them all; a search across all of China keeps going city after city. Place ids and place links always return their place.",
            "default": 100
          },
          "minRating": {
            "title": "⭐ Minimum rating",
            "enum": [
              "3",
              "3.5",
              "4",
              "4.5",
              "4.8"
            ],
            "type": "string",
            "description": "Keep only the places rated at least this, out of 5. Places without a rating are left out, and the search reads on until it has its number of places. Place ids and place links always return their place. Leave empty to keep every place."
          },
          "startUrls": {
            "title": "🔗 Tencent Maps links",
            "type": "array",
            "description": "Paste map.qq.com links. A place link (<code>https://map.qq.com/m/detail/poi/poid=…</code>) returns that place; a search link (<code>https://map.qq.com/?what=咖啡&city=上海</code>) returns its results.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "poiIds": {
            "title": "🆔 Place IDs",
            "type": "array",
            "description": "Tencent Maps place ids, for example <code>18195819856201555906</code>: the <code>id</code> column of a previous run or the <code>poid</code> of a place link. One row per place, handy to refresh places you already track.",
            "items": {
              "type": "string"
            }
          },
          "includeReviewCount": {
            "title": "📊 Add Dianping review count, deals and hotel rates",
            "type": "boolean",
            "description": "Adds the place's full review count on Dianping (大众点评), often in the thousands where the map listing shows a handful, its group-buy vouchers and set meals with price and conditions, for restaurants their Dianping cuisine (<code>四川火锅</code>) and whether they take table bookings, run an online queue and deliver, and for hotels the stars, the starting price on each booking site (Ctrip, eLong, Meituan) and the lowest nightly rate over the next two weeks. Also the local rankings and WeChat mini programs of the place. Turn off for a faster list of names, addresses and phones (100 places in about 3 seconds).",
            "default": true
          },
          "includeDetails": {
            "title": "📸 Add photos, menu and visitor tags",
            "type": "boolean",
            "description": "Adds the page of each place to its row: the main photo and up to about 200 photo links, the 10 most recommended dishes with their price, and the visitors' tags with how many gave them (<code>餐后赠送小零食</code> × 472).",
            "default": false
          },
          "maxReviews": {
            "title": "💬 Reviews per place",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Adds up to this many visitor reviews to each place (author, rating out of 5, date, text and photos), in a <code>reviews</code> list on the place's row. The page of a place shows 10 reviews at most. Any number above 0 also turns on the place details.",
            "default": 0
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}