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"
}

Autorizaciones

Authorization

string

header

requerido

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

Encabezados

enum<string>

Serp Google Param Accept

Opciones disponibles:

application/json

Cuerpo

application/json

Option 1
Option 2

type

enum<string>

predeterminado:search

requerido

Serp Google Type

Opciones disponibles:

images

query

string

requerido

Serp Google Query

Required string length: 1 - 2048

Pattern: .*\S.*

Ejemplo:

"apple inc"

page

integer

predeterminado:1

Serp Google Page

Rango requerido: 1 <= x <= 100

range

enum<string>

Serp Google Range

Opciones disponibles:

h,

d,

w,

m,

y,

qdr:h,

qdr:d,

qdr:w,

qdr:m,

qdr:y

number

integer

predeterminado:10

Serp Google Number

Rango requerido: 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.

Opciones disponibles:

large,

medium,

icon,

2mp,

4mp,

6mp,

8mp,

10mp,

12mp,

15mp,

20mp,

40mp,

70mp

Respuesta

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 IA

GLM

Kimi

Claude IA

DeepSeek IA

Grok

Generación OpenAI

Diálogo de IA

Generación de imagen ByteDance Seedream

Generación de imagen Nano Banana

Generación de imágenes Flux

Generación Midjourney

Producción de foto de ID de IA

Transformación facial

Generación de código QR artístico

Generación de video ByteDance Seedance

Generación de video Sora

Generación de video Veo

Generación de video Kling

Generación de video Tongyi Wansiang

Generación de video Luma

Generación de video Hailuo

Generación de música Suno

Generación de música Fish

Generación de música Producer

Motor de búsqueda

Generación de enlaces cortos

Información de TikTok

Información de Twitter

traducción de localización

Reconocimiento de códigos de verificación numéricos en inglés

Servicio de reconocimiento de código de verificación Recaptcha

Servicio de reconocimiento de código de verificación hCaptcha

Autenticación de identidad

Proxy de conexión directa ADSL

Get Google search results

Autorizaciones

Encabezados

Cuerpo

Respuesta