Get Google search results

curl --request POST \
  --url https://api.acedata.cloud/serp/google \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "search",
  "query": "apple inc"
}
'

import requests

url = "https://api.acedata.cloud/serp/google"

payload = {
    "type": "search",
    "query": "apple inc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'search', query: 'apple inc'})
};

fetch('https://api.acedata.cloud/serp/google', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "organic": [
    {
      "title": "x402 protocol documentation",
      "link": "https://www.x402.org/",
      "snippet": "Documentation and resources for the x402 payment protocol.",
      "position": 1
    }
  ],
  "cost": {
    "amount": 0.01,
    "currency": "credit"
  }
}

{
  "error": {
    "code": "token_mismatched",
    "message": "The specified token is not matched with API."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "no_api",
    "message": "API does not exist, please make sure url is correct."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "too_many_requests",
    "message": "You have exceeded the rate limit."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "api_error",
    "message": "Internal server error."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

POST

serp

google

Get Google search results

curl --request POST \
  --url https://api.acedata.cloud/serp/google \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "search",
  "query": "apple inc"
}
'

import requests

url = "https://api.acedata.cloud/serp/google"

payload = {
    "type": "search",
    "query": "apple inc"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'search', query: 'apple inc'})
};

fetch('https://api.acedata.cloud/serp/google', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "organic": [
    {
      "title": "x402 protocol documentation",
      "link": "https://www.x402.org/",
      "snippet": "Documentation and resources for the x402 payment protocol.",
      "position": 1
    }
  ],
  "cost": {
    "amount": 0.01,
    "currency": "credit"
  }
}

{
  "error": {
    "code": "token_mismatched",
    "message": "The specified token is not matched with API."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "invalid_token",
    "message": "The specified token is invalid or wrong."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in Ace Data Cloud."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "no_api",
    "message": "API does not exist, please make sure url is correct."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "too_many_requests",
    "message": "You have exceeded the rate limit."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

{
  "error": {
    "code": "api_error",
    "message": "Internal server error."
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

承認

Authorization

string

header

必須

API token from https://platform.acedata.cloud

ヘッダー

enum<string>

Serp Google Param Accept

利用可能なオプション:

application/json

ボディ

application/json

Option 1
Option 2

type

enum<string>

デフォルト:search

必須

Serp Google Type

利用可能なオプション:

images

query

string

必須

Serp Google Query

Required string length: 1 - 2048

Pattern: .*\S.*

例:

"apple inc"

page

integer

デフォルト:1

Serp Google Page

必須範囲: 1 <= x <= 100

range

enum<string>

Serp Google Range

利用可能なオプション:

h,

d,

w,

m,

y,

qdr:h,

qdr:d,

qdr:w,

qdr:m,

qdr:y

number

integer

デフォルト:10

Serp Google Number

必須範囲: 1 <= x <= 100

country

string

Serp Google Country

Required string length: 1 - 32

language

string

Serp Google Language

Required string length: 1 - 32

image_size

enum<string>

Image size filter. Only valid when type is images.

利用可能なオプション:

large,

medium,

icon,

2mp,

4mp,

6mp,

8mp,

10mp,

12mp,

15mp,

20mp,

40mp,

70mp

レスポンス

Serp Google Response 200

Structured search results. Available result collections depend on the requested search type.

organic

object[]

Show child attributes

images

object[]

Show child attributes

news

object[]

Show child attributes

videos

object[]

Show child attributes

places

object[]

Show child attributes

maps

object[]

Show child attributes

people_also_ask

object[]

Show child attributes

answer_box

object

knowledge_graph

object

cost

object

Show child attributes

Gemini AI

GLM

Kimi

Claude AI

DeepSeek AI

Grok

OpenAI生成

AI対話

ByteDance Seedream画像生成

Nano Banana画像生成

Flux画像生成

Midjourney生成

AI ID写真制作

顔変換

アートQRコード生成

ByteDance Seedance動画生成

Sora動画生成

Veo動画生成

Kling動画生成

Tongyi Wansiang動画生成

Luma動画生成

Hailuo動画生成

Suno音楽生成

Fish音楽生成

Producer音楽生成

検索エンジン

ショートリンク生成

TikTok情報

Twitter情報

ローカリゼーション翻訳

英数字認証コード認識

Recaptcha認証コード認識サービス

hCaptcha認証コード認識サービス

本人認証

ADSLダイレクト接続プロキシ

Get Google search results

承認

ヘッダー

ボディ

レスポンス