openapi: 3.0.0
info:
  title: Google About This Domain API
  version: 1.0.0
  description: |
    Google About This Domain API returns information about a domain, including source credibility data, indexing history, social profiles, and related web results.

    Use this API to verify source credibility, check domain age, or gather competitive intelligence about any website.
servers:
  - url: https://www.searchapi.io/api/v1
paths:
  /search:
    get:
      operationId: searchGoogleAboutThisDomain
      summary: Get About This Domain data
      description: Returns Google's metadata about a specific domain, including when it was first indexed, how it describes itself, and what third-party sources say about it.
      security:
        - ApiKeyAuth: []
        - ApiKeyQuery: []
      parameters:
        - $ref: '#/components/parameters/engine'
        - $ref: '#/components/parameters/api_key'
        - $ref: '#/components/parameters/domain'
        - $ref: '#/components/parameters/hl'
        - $ref: '#/components/parameters/gl'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
        '400':
          description: Validation Error. There is an issue with query parameters, such as missing required parameters or invalid values.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Authentication Error. The API key is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate Limit Exceeded. The number of allowed requests has been exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server Error. Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Timeout. We could not retrieve results in 90 seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use Bearer authentication. Format: "Bearer YOUR_API_KEY"'
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: Pass API key as query parameter
  parameters:
    engine:
      name: engine
      in: query
      required: true
      description: Must be set to google_about_this_domain.
      schema:
        type: string
        enum: ["google_about_this_domain"]
    api_key:
      name: api_key
      in: query
      required: true
      description: Your API key for authentication.
      schema:
        type: string
    domain:
      name: domain
      in: query
      required: true
      description: The domain you want to get information about.
      schema:
        type: string
    hl:
      name: hl
      in: query
      required: false
      description: Defines the interface language of the search.
      schema:
        type: string
        default: "en"
    gl:
      name: gl
      in: query
      required: false
      description: Defines the country of the search. Uses a two-letter country code (e.g., us, lt, gb).
      schema:
        type: string
  schemas:
    SearchResponse:
      type: object
      properties:
        search_metadata:
          $ref: '#/components/schemas/SearchMetadata'
        search_parameters:
          $ref: '#/components/schemas/SearchParameters'
        about_this_result:
          $ref: '#/components/schemas/AboutThisResult'
        knowledge_graph:
          $ref: '#/components/schemas/KnowledgeGraph'
        ai_overview:
          $ref: '#/components/schemas/AiOverview'
        in_their_own_words:
          $ref: '#/components/schemas/InTheirOwnWords'
        web_results:
          type: array
          description: Web results about the domain from third-party websites.
          items:
            $ref: '#/components/schemas/WebResult'
        site_first_indexed_by_google:
          $ref: '#/components/schemas/SiteFirstIndexed'
        error:
          type: string
          description: Error message when no results are found.
    SearchMetadata:
      type: object
      required: [id, status, created_at]
      properties:
        id:
          type: string
          description: Unique identifier for the search request.
        status:
          type: string
          description: Status of the search request.
        created_at:
          type: string
          format: date-time
          description: Timestamp when the search was created.
        request_time_taken:
          type: number
          description: Time taken to make the request in seconds.
        parsing_time_taken:
          type: number
          description: Time taken to parse the results in seconds.
        total_time_taken:
          type: number
          description: Total time taken for the search in seconds.
        request_url:
          type: string
          description: Google URL for this search.
        html_url:
          type: string
          description: URL to view HTML results.
        json_url:
          type: string
          description: URL to view JSON results.
    SearchParameters:
      type: object
      properties:
        engine:
          type: string
          description: The search engine used.
        domain:
          type: string
          description: The domain queried.
        hl:
          type: string
          description: The interface language of the search.
        gl:
          type: string
          description: The country of the search.
    AboutThisResult:
      type: object
      description: Header information about the queried domain.
      properties:
        title:
          type: string
          description: The title of the website.
        link:
          type: string
          description: The URL of the website.
        displayed_link:
          type: string
          description: The displayed URL.
        favicon:
          type: string
          description: URL of the website's favicon.
    KnowledgeGraph:
      type: object
      description: Knowledge graph information about the domain. Returned when Google has structured entity data. Either knowledge_graph or ai_overview will be present, not both.
      properties:
        title:
          type: string
          description: The title of the entity.
        subtitle:
          type: string
          description: A subtitle or category for the entity.
        description:
          type: string
          description: A text description of the entity.
        source:
          $ref: '#/components/schemas/KnowledgeGraphSource'
        profiles:
          type: array
          description: Social media and website profiles.
          items:
            $ref: '#/components/schemas/Profile'
      additionalProperties:
        type: string
        description: Dynamic fact fields extracted from the knowledge panel. Keys are derived from fact labels (e.g., founded, ceo, headquarters). Some facts may include a corresponding _link field.
    KnowledgeGraphSource:
      type: object
      description: The source of the knowledge graph description.
      properties:
        name:
          type: string
          description: Name of the source.
        link:
          type: string
          description: URL of the source.
    Profile:
      type: object
      description: A social media or website profile.
      properties:
        name:
          type: string
          description: Name of the platform or website.
        link:
          type: string
          description: URL to the profile.
        image:
          type: string
          description: Thumbnail image for the profile.
    AiOverview:
      type: object
      description: AI-generated overview about the domain. Returned when Google provides an AI summary instead of a knowledge graph. Either knowledge_graph or ai_overview will be present, not both.
      properties:
        text_blocks:
          type: array
          description: Structured text blocks from the AI overview.
          items:
            $ref: '#/components/schemas/TextBlock'
        reference_links:
          type: array
          description: Reference links cited in the AI overview.
          items:
            $ref: '#/components/schemas/ReferenceLink'
        markdown:
          type: string
          description: The AI overview content formatted as markdown.
    TextBlock:
      type: object
      description: A text block from the AI overview.
      properties:
        type:
          type: string
          description: The type of text block (header, paragraph).
        answer:
          type: string
          description: The text content of the block.
    ReferenceLink:
      type: object
      description: A reference link from the AI overview.
      properties:
        index:
          type: integer
          description: The index of the reference in the overview.
        title:
          type: string
          description: Title of the reference.
        link:
          type: string
          description: URL of the reference.
        source:
          type: string
          description: Name of the source.
        thumbnail:
          type: string
          description: Thumbnail image for the reference.
    InTheirOwnWords:
      type: object
      description: How the domain describes itself, typically from their About page.
      properties:
        snippet:
          type: string
          description: Text from the domain's self-description.
        link:
          type: string
          description: Link to the About page or source.
    WebResult:
      type: object
      description: A web result about the domain.
      properties:
        title:
          type: string
          description: Title of the web result.
        link:
          type: string
          description: URL of the web result.
        source:
          type: string
          description: Source name of the web result.
        displayed_link:
          type: string
          description: Displayed URL path.
        snippet:
          type: string
          description: Text snippet from the result.
        date:
          type: string
          description: Publication date of the result.
        rating:
          type: number
          description: Rating if available.
        reviews:
          type: integer
          description: Number of reviews if available.
        about_page_link:
          type: string
          description: Link to the About This Result page for this result.
    SiteFirstIndexed:
      type: object
      description: When Google first indexed this site.
      properties:
        snippet:
          type: string
          description: Description of when the site was first indexed.
        link:
          type: string
          description: Link to Wayback Machine archive.
    ErrorResponse:
      type: object
      required: [error]
      properties:
        error:
          type: string
          description: Error message describing what went wrong.