scraper-api-com Google API

openapi: 3.2.0
info:
  title: scraper-api.com Google API
  version: 0.1.0
  description: 'Self-hosted social media scraping API — a drop-in replacement for scrapecreators.com.


    ## Authentication

    Every request must send your API key in the `x-api-key` header.


    ## Credits

    Billing is credit-based: **1 request = 1 credit** (some endpoints cost more — see each endpoint''s description). Credits are **non-expiring** — buy once, use whenever.


    Response bodies match the ScrapeCreators shapes so existing integrations work unchanged.'
  contact:
    name: Fabian Bitter
    email: fabian@bitter.de
servers:
- url: https://api.scraper-api.com
  description: Production
security:
- apiKeyAuth: []
tags:
- name: Google
  description: 'Google: read-only. 1 public endpoint, no account needed.'
paths:
  /v1/google/business:
    get:
      tags:
      - Google
      summary: Get a Google business listing (Google Business Profile) by search query or…
      operationId: google_v1_business
      description: '**Live endpoint.** Credit cost: **1** (1 request = 1 credit).'
      security:
      - apiKeyAuth: []
      parameters:
      - name: query
        in: query
        required: false
        description: 'Business name, ideally with its city or street so the match is unambiguous. Provide at least one of: query, url.'
        schema:
          type: string
          example: Hotel Adlon Kempinski Berlin
      - name: url
        in: query
        required: false
        description: 'Full google.com/maps place URL. Shortened share links (maps.app.goo.gl) are not accepted. Provide at least one of: query, url.'
        schema:
          type: string
          example: https://www.google.com/maps/place/Hotel+Adlon+Kempinski+Berlin/@52.5160742,13.3804268,17z
      - name: language
        in: query
        required: false
        description: Interface language for the category names. Defaults to en.
        schema:
          type: string
          example: de
      responses:
        '200':
          description: Platform-native JSON payload (ScrapeCreators-compatible).
          content:
            application/json:
              example:
                success: true
                data:
                  place_id: ChIJHQQciMZRqEcR2X4b8-vf5Bk
                  feature_id: 0x47a851c6881c041d:0x19e4dfebf31b7ed9
                  name: Hotel Adlon Kempinski Berlin
                  rating: 4.6
                  review_count: 2312
                  categories:
                  - Hotel
                  category: Hotel
                  description: Grand hotel at the Brandenburg Gate.
                  address:
                    formatted: Hotel Adlon Kempinski Berlin, Unter den Linden 77, 10117 Berlin, Germany
                    lines:
                    - Unter den Linden 77
                    - 10117 Berlin
                    - Germany
                  phone: '+493022610'
                  phone_display: +49 30 22610
                  website: https://www.kempinski.com/de/hotel-adlon
                  website_label: kempinski.com
                  latitude: 52.5160742
                  longitude: 13.3804268
                  maps_url: https://www.google.com/maps/preview/place/Hotel+Adlon+Kempinski+Berlin
                  reviews_url: https://search.google.com/local/reviews?placeid=ChIJHQQciMZRqEcR2X4b8-vf5Bk
        '400':
          description: Missing or invalid parameters.
          content:
            application/json:
              example:
                error:
                  message: 'Missing required parameter(s): handle'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              example:
                error:
                  message: Invalid API key.
        '402':
          description: Not enough credits.
          content:
            application/json:
              example:
                error:
                  message: Insufficient credits.
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              example:
                error:
                  message: Rate limit exceeded.
        '502':
          description: Upstream scrape failed.
          content:
            application/json:
              example:
                error:
                  message: Upstream scrape failed.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your scraper-api.com API key.
x-tagGroups:
- name: Platforms
  tags:
  - Instagram
  - TikTok
  - YouTube
  - Facebook
  - LinkedIn
  - Twitter
  - Spotify
  - Apple Music
  - Kleinanzeigen
  - Quoka
  - markt.de
  - mobile.de
  - '11880'
  - Gelbe Seiten
  - ImmobilienScout24
  - immowelt
  - WG-Gesucht
  - Bayut
  - LOVOO
  - Jaumo
  - Tinder
  - Bumble
  - Snapchat
  - Google
  - Arbeitsagentur
  - Ausbildung.de
  - meinestadt.de