Skip to content

google.com

Google API

Query public Google data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.

Extracts organic results from Google Search by keyword, with fixed geolocation in Brazil and pagination per page.

GeckoAPI is independent of Google. This integration reads public data; it does not grant access to private accounts or account management operations.

Available operations

Search the web

google.com:plp

Extracts organic results from Google Search by keyword, with fixed geolocation in Brazil and pagination per page.

1 credit per request

Find places and businesses

google.com:places

Extracts locations from Google Maps by keyword and reference address.

1 credit per request

These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.

Make your first request

The example uses search the web. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.

Google · cURL
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "Royal Imóveis Rj",
  "target": "google.com",
  "type": "plp",
  "page": 1
}'

Example JSON response

Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.

Abbreviated response
{
  "requestId": "99999999-1111-4111-8111-999999999999",
  "executionId": "99999999-2222-4222-8222-999999999999",
  "data": {
    "source": "google.com",
    "type": "plp",
    "url": "https://www.google.com/search?q=Royal+Im%C3%B3veis+Rj",
    "requestUrl": "https://www.google.com/search?q=Royal+Im%C3%B3veis+Rj",
    "extractedAt": "2026-03-21T14:44:36Z",
    "query": "Royal Imóveis Rj",
    "displayedQuery": "Royal Imóveis Rj",
    "searchedQuery": "Royal Imóveis Rj",
    "geolocation": "BR",
    "device": "desktop",
    "page": 1,
    "resultsPerPage": 6,
    "offset": 0,
    "primaryResults": 6,
    "totalResults": 1090000,
    "nextPage": 2,
    "nextPageUrl": "https://www.google.com/search?q=Royal+Im%C3%B3veis+Rj&start=10",
    "items": [
      {
        "position": 1,
        "rank": 1,
        "title": "Royal Imóveis RJ",
        "description": "Unidade Freguesia de Jacarepaguá. Estrada dos Três Rios, 1097. - Loja G. Freguesia de Jacarepaguá. Rio de Janeiro/RJ.",
        "url": "https://www.royalimoveisrj.com.br/",
        "displayedUrl": "https://www.royalimoveisrj.com.br",
        "domain": "royalimoveisrj.com.br"
      },
      {
        "position": 2,
        "rank": 2,
        "title": "Royal Imóveis RJ (@royalimoveisrj)",
        "description": "6.1K+ followers · 918 posts · Imobiliária ⭐ A mais avaliada no Google Compra, Venda, Locação e Administração de imóveis Freguesia - JPA Creci J- ...",
        "url": "https://www.instagram.com/royalimoveisrj/",
        "displayedUrl": "Mais de 6,1 mil seguidores",
        "domain": "instagram.com"
      }
    ]
  }
}
Explore the full response and field descriptions

Integrate with REST or MCP

Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.

Authentication and getting started

Ready to test the Google API?

Open the documented example in the sandbox and inspect the response before integrating it into your application.