find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/hproxy-com:hproxy-com-google-scraper-api-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: HProxy Google scraper API
  version: 1.0.0
  description: 'Buy and manage proxies from a prepaid wallet, run the Scraper API, or use the free no-key APIs: a live proxy list, a proxy checker and an IP lookup. JSON in, JSON out. Money is always integer cents (120 = $1.20), never floats.'
  contact:
    url: https://hproxy.com/contact
  license:
    name: Proprietary
servers:
- url: https://hproxy.com
  description: Production
security:
- ApiKeyAuth: []
tags:
- name: Google scraper API
paths:
  /api/v1/scrape/google/search:
    get:
      operationId: scrapeGoogleSearch
      summary: Google Search Results
      description: Returns structured JSON for **Google Search Results**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
      tags:
      - Google scraper API
      parameters:
      - name: x-api-key
        in: query
        required: true
        description: Your HProxy API key with the scrape scope.
        schema:
          type: string
      - name: query
        in: query
        required: true
        description: Search term or keyword.
        schema:
          type: string
      - name: region
        in: query
        required: false
        description: Two-letter region/country code, e.g. US.
        schema:
          type: string
      - name: date_posted
        in: query
        required: false
        description: 'Filter by date, as YYYY-MM-DD. Allowed values: `last-hour`, `last-day`, `last-week`, `last-month`, `last-year`.'
        schema:
          type: string
      - name: page
        in: query
        required: false
        description: Pagination token from the previous response.
        schema:
          type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input. The body names the field and the accepted set.
        '401':
          description: Missing or invalid API key.
        '429':
          description: Rate limited. Retry after the delay in the response.
      security:
      - ApiKeyAuth: []
  /api/v1/scrape/google/ad-company:
    get:
      operationId: scrapeGoogleAdCompany
      summary: Google Ad Library Company Ads
      description: Returns structured JSON for **Google Ad Library Company Ads**. Billed **$0.03725 per successful call** ($37.25 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
      tags:
      - Google scraper API
      parameters:
      - name: x-api-key
        in: query
        required: true
        description: Your HProxy API key with the scrape scope.
        schema:
          type: string
      - name: domain
        in: query
        required: true
        description: The domain parameter. Send this **or** `advertiser_id`.
        schema:
          type: string
      - name: advertiser_id
        in: query
        required: true
        description: Identifier from a previous response. Send this **or** `domain`.
        schema:
          type: string
      - name: topic
        in: query
        required: false
        description: 'The topic parameter. Allowed values: `all`, `political`.'
        schema:
          type: string
      - name: region
        in: query
        required: false
        description: Two-letter region/country code, e.g. US.
        schema:
          type: string
      - name: start_date
        in: query
        required: false
        description: Filter by date, as YYYY-MM-DD.
        schema:
          type: string
      - name: end_date
        in: query
        required: false
        description: Filter by date, as YYYY-MM-DD.
        schema:
          type: string
      - name: platform
        in: query
        required: false
        description: 'The platform parameter. Allowed values: `google_maps`, `google_play`, `google_search`, `google_shopping`, `youtube`.'
        schema:
          type: string
      - name: format
        in: query
        required: false
        description: 'The format parameter. Allowed values: `text`, `image`, `video`.'
        schema:
          type: string
      - name: get_ad_details
        in: query
        required: false
        description: Also include ad details in the response.
        schema:
          type: boolean
      - name: cursor
        in: query
        required: false
        description: Pagination token from the previous response.
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input. The body names the field and the accepted set.
        '401':
          description: Missing or invalid API key.
        '429':
          description: Rate limited. Retry after the delay in the response.
      security:
      - ApiKeyAuth: []
  /api/v1/scrape/google/ad:
    get:
      operationId: scrapeGoogleAd
      summary: Google Ad Detail
      description: Returns structured JSON for **Google Ad Detail**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
      tags:
      - Google scraper API
      parameters:
      - name: x-api-key
        in: query
        required: true
        description: Your HProxy API key with the scrape scope.
        schema:
          type: string
      - name: url
        in: query
        required: true
        description: Target URL (profile, post or video).
        schema:
          type: string
      - name: trim
        in: query
        required: false
        description: Return a slimmed-down payload (drops verbose fields).
        schema:
          type: boolean
      - name: cache_max_age
        in: query
        required: false
        description: 'Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.'
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input. The body names the field and the accepted set.
        '401':
          description: Missing or invalid API key.
        '429':
          description: Rate limited. Retry after the delay in the response.
      security:
      - ApiKeyAuth: []
  /api/v1/scrape/google/advertiser-search:
    get:
      operationId: advertiser-search
      summary: Google Advertiser Search
      description: Returns structured JSON for **Google Advertiser Search**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
      tags:
      - Google scraper API
      parameters:
      - name: x-api-key
        in: query
        required: true
        description: Your HProxy API key with the scrape scope.
        schema:
          type: string
      - name: query
        in: query
        required: true
        description: Search term or keyword.
        schema:
          type: string
      - name: cursor
        in: query
        required: false
        description: Pagination token from the previous response.
        schema:
          type: string
      - name: region
        in: query
        required: false
        description: Two-letter region/country code, e.g. US.
        schema:
          type: string
      - name: trim
        in: query
        required: false
        description: Return a slimmed-down payload (drops verbose fields).
        schema:
          type: boolean
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input. The body names the field and the accepted set.
        '401':
          description: Missing or invalid API key.
        '429':
          description: Rate limited. Retry after the delay in the response.
      security:
      - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your API key. Free keyless endpoints ignore it.
x-endpoint-count: 163
x-generated-from: https://hproxy.com/docs
x-llms: https://hproxy.com/llms-full.txt