Search Google | SociallisteningAPI

Search Google results by keyword and return normalized titles, descriptions, URLs, and result metadata for available result types.

Endpoint

Path: /api/v1/google/search
Cost: 1 credit per successful request

Query parameters

Name	Required	Description	Example
`query`	Yes	The keyword or phrase to search for.	`social listening`
`exact`	No	Search for the exact phrase by wrapping the query in double quotes. Defaults to true. Set to false to send the query unchanged.	`true`
`raw`	No	Include the unchanged provider response in the raw field. Defaults to false.	`true`

curl --get 'https://api.sociallisteningapi.com/api/v1/google/search' \
  --data-urlencode 'query=social listening' \
  --data-urlencode 'exact=true' \
  --data-urlencode 'raw=true' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

{
  "success": true,
  "platform": "google",
  "endpoint": "/api/v1/google/search",
  "data": {
    "items": [
      {
        "id": "https://example.com/social-listening-guide",
        "platform": "google",
        "url": "https://example.com/social-listening-guide",
        "title": "A practical guide to social listening",
        "description": "Learn how to find and review public conversations about your brand.",
        "published_at": null
      }
    ]
  },
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  },
  "raw": {
    "results": []
  },
  "request_id": "req_example123",
  "credits_used": 1,
  "credits_remaining": 99
}