Google Play 電影商店 API

API 詳情

請求端點 GET https://serpapi.abcproxy.com/search

**說明 **

我們的 Google Play 電影商店 API 允許您從 Google Play 電影商店頁面抓取結果。此 API 可透過以下端點存取：/search?engine=google_play_movies。

使用者可以使用 GET 請求查詢以下網址：https://serpapi.abcproxy.com/search?engine=google_play_movies。請前往 工作臺 查看即時互動演示

---

請求方式

HTTP 請求範例

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_play_movies" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "google_play_movies",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "google_play_movies",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=google_play_movies&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google_play_movies',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "google_play_movies")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "google_play_movies";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=google_play_movies" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API 參數說明

搜尋參數

參數名稱	類型	必填項	說明	範例
q	字符串	否	定義您想要在 Google Play 應用程式商店中搜尋的關鍵字。	Coffee

地區與語言設定

參數名稱	類型	必填項	說明	範例
gl	字符串	No	指定用於 Google Play 搜尋的國家，使用兩碼國家代碼，例如 us（美國，預設值）、uk（英國）、fr（法國）。完整支援國家清單可參見：Google Play Countries，也可前往 Google countries page 查詢代碼。	us
hl	字符串	No	指定用於 Google Play 搜尋的語言，使用兩碼語言代碼，例如 en（英文，預設值）、es（西班牙文）、fr（法文）。完整支援語言清單請見 Google languages page。	en

Google Play分類

參數名稱	類型	必填項	說明	範例
movies_category	字符串	否	定義要搜尋的電影商店分類。完整支援的電影分類請參見 Google Play Movies Categories。	1

高級Google Play參數

參數名稱	類型	必填項	說明	範例
age	字符串	否	定義兒童分類下的年齡子類別。此參數僅限與 apps_category=FAMILY（兒童應用程式）一起使用。 可使用的選項包括： - AGE_RANGE1：5 歲以下 - AGE_RANGE2：6 至 8 歲 - AGE_RANGE3：9 至 12 歲 預設值為：12 歲以下所有年齡	-

分頁參數

參數名稱	類型	必填項	說明	範例
next_page_token	字符串	否	用於取得下一頁結果的分頁令牌。不可與 section_page_token、see_more_token 和 chart 一起使用。	-
section_page_token	字符串	否	從個別區塊中取得分頁結果所用的分頁令牌，是 see_more_token 的更安全版本，通常存在於可進行分頁的資料列中。不可與 next_page_token、see_more_token、chart 同時使用。	-
chart	字符串	否	顯示排行榜結果，每次最多回傳 50 筆資料。每個商店包含不同排行榜，需使用對應的值。您可以從 JSON 回應中的 chart_options[index].value 取得（如：chart=topselling_free）。不可與 section_page_token、see_more_token、next_page_token 同時使用。	-
see_more_token	字符串	否	從個別區塊中取得分頁結果所使用的 "查看更多" 令牌，通常出現在下一頁的回應中。不可與 section_page_token、next_page_token 和 chart 同時使用。	-

SerpApi 專屬參數

參數名稱	類型	必填項	說明	範例
engine	字符串	是	設定為 google_play_movies 以使用 Google Play Movies API 引擎。	google_play_movies
no_cache	布爾值	否	是否強制 SerpApi 即時重新擷取資料，即使有快取結果也不使用。預設為 false（允許使用快取）。若設為 true，則必定重新擷取。快取有效期為 1 小時，且使用快取不計費。	trueorfalse
api_key	字符串	是	指定要使用的 SerpApi 私密金鑰。	-

---

響應

成功回應（HTTP 200）

響應機构

{
  "search_metadata": {
    "raw_html_file": "https://webserp.abcproxy.com/files/1c9399bedf6e83cd/5da48a1d-e067-4b4f-8f66-5354283ed34c.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/1c9399bedf6e83cd/5da48a1d-e067-4b4f-8f66-5354283ed34c.xray",
    "total_time_taken": "5.4297",
    "id": "5da48a1d-e067-4b4f-8f66-5354283ed34c",
    "json_endpoint": "https://webserp.abcproxy.com/files/1c9399bedf6e83cd/5da48a1d-e067-4b4f-8f66-5354283ed34c.json",
    "created_at": "2025-04-02 16:24:21",
    "google_news_url": "https://play.google.com/store/search?c=movies&q=coffee"
  },
  "search_parameters": {
    "engine": "google_play_movies",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "q": "coffee"
  },
  "organic_results": [
    {
      "title": "film"
      "items": [
        {
          "link": "/store/movies/details/Coffee?id=7FA4A772F72C0C5BMV",
          "thumbnail": "https://play-lh.googleusercontent.com/proxy/YHpA3tGgWX2rNDntay6y8SnknG2ms17u1pQXADO4RTp8ZC_ND1nHntfri7ef1NgdpamM660Hspcv32rpD8h2aj5rynNmjDcfWhUx4fHo2wGDP-nJQcMNFn3KiiyHjkpKzR4sIs6OWIzei6nnvtogbGO1ffJ-cPldaiVYVA=s256-rw",
          "title": "Coffee"
        },
        {
          "rating": "4.1",
          "price": "US$2.99",
          "thumbnail": "https://play-lh.googleusercontent.com/KKtvOxoFEi-kwkAK9V9PRvAHnf-7qG76QXU7FnJHMvoIw58_x7qC7YqoEmuhUqoVs1uI2A=s256-rw",
          "title": "Hot Coffee",
          "link": "/store/movies/details/Hot_Coffee?id=KmEYWCg0J7Q"
        },
        {
          "title": "Full Metal Village",
          "link": "/store/movies/details/Full_Metal_Village?id=45jBUkhStqg",
          "rating": "2.5",
          "price": "US$2.99",
          "thumbnail": "https://play-lh.googleusercontent.com/x0r4QB_2di0MokUGaWC7r0MzhNFabV-_wsl76wMtiWTwDF4T08F1dnV176KDPwfKfM_v=s256-rw"
        },
          "..."
      ],
    },
    {
      "title": "television program",
      "items": [
        {
          "title": "Inside the Food Factory",
          "link": "/store/tv/show/Inside_the_Food_Factory?id=QzXKJNpcpwg.P",
          "thumbnail": "https://play-lh.googleusercontent.com/8EzyaB0cxfIJJb_fGj6p-TdAV1x2X_TA4sJhNxhrerE_ECiydgC74a4NkWPDSHUypRvNqk6Gr8P6EDQWw9U=s256-rw"
        },
        {
          "title": "Coffee Cart Ban",
          "link": "/store/tv/show?id=-sRNnDpRvBo&cdid=tvseason-LsNKoyHpArX4uxpaBXyE6w&gdid=tvepisode-OjTIvdOj6dQ",
          "price": "0.99",
          "thumbnail": "https://play-lh.googleusercontent.com/Dbcg27_EdqwImCvFfZUDDYXAEM4ZwGwWZSMlf5NY0J4t6PkEki5SXIYaP83-Ymaaqqnz=s256-rw"
        },
        {
          "title": "Planet Bears / Coffee Cave",
          "link": "/store/tv/show?id=8qBdpu87wlc&cdid=tvseason-UVWSsh7S25IZoaEEWBUA9Q&gdid=tvepisode-hsSakym32Cw",
          "price": "0.99",
          "thumbnail": "https://play-lh.googleusercontent.com/2NqyCDMFiskfnnUP0qyXg56pqhSVUhKXfXTODiaaj67ro2LZM5eftdJf0tH9-12WH2JA_nmkQ9NuvIHgB9ko=s256-rw"
        },
        "..."
     ],
   }
}

響應欄位

Field	Type	Description
search_metadata	對象	搜尋的元資訊，如 ID 與時間
search_parameters	對象	實際使用的查詢參數
organic_results	對象數組	自然搜尋結果

---

錯誤回應

常見錯誤碼與說明

HTTP 狀態碼	錯誤碼	說明
200	400	API 金鑰不能為空
200	401	參數錯誤
200	402	API 金鑰錯誤
200	403	餘額不足
200	404	扣款失敗
200	405	記錄使用次數失敗
200	406	不支援的搜尋引擎
200	407	網路錯誤
200	408	找不到檔案
200	409	限制參數錯誤
200	410	建立 URL 錯誤
200	411	查詢歷史記錄失敗
200	412	找不到 JSON 結果
200	413	擷取 HTML 失敗
200	414	HTML 為空
200	429	請求次數過多

錯誤回應範例

{
  "code": 400,
  "message": "API Key can not be empty"
}

---