{
  "opencollection": "1.0.0",
  "info": {
    "name": "ValueSERP Search Images News API",
    "version": "1.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "api_key",
      "value": "{{api_key}}",
      "placement": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "News",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Google News Search",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.valueserp.com/search#news",
            "params": [
              {
                "name": "api_key",
                "value": "demo",
                "type": "query",
                "description": "Your ValueSERP API key. Use \"demo\" for testing limited queries."
              },
              {
                "name": "search_type",
                "value": "news",
                "type": "query",
                "description": "Must be set to \"news\"."
              },
              {
                "name": "q",
                "value": "pizza",
                "type": "query",
                "description": "The keyword or search query to use."
              },
              {
                "name": "location",
                "value": "united states",
                "type": "query",
                "description": "Geographic location for the search. Accepts location names (e.g., \"manhattan,new york,united states\") or GPS coordinates (e.g., \"lat 43.437677,lon 3.8392765\")."
              },
              {
                "name": "location_auto",
                "value": "",
                "type": "query",
                "description": "When true, automatically updates gl and hl parameters based on the built-in location value. Defaults to true."
              },
              {
                "name": "google_domain",
                "value": "google.com",
                "type": "query",
                "description": "The Google domain to use for the search."
              },
              {
                "name": "gl",
                "value": "us",
                "type": "query",
                "description": "Determines the Google country to use for the query. ISO 3166-1 alpha-2 country code."
              },
              {
                "name": "hl",
                "value": "en",
                "type": "query",
                "description": "Determines the Google UI language to return results in. BCP-47 language code."
              },
              {
                "name": "lr",
                "value": "lang_en",
                "type": "query",
                "description": "Limits results to pages in the specified language."
              },
              {
                "name": "cr",
                "value": "countryUS",
                "type": "query",
                "description": "Limits results to pages from the specified country."
              },
              {
                "name": "page",
                "value": "1",
                "type": "query",
                "description": "The results page number to retrieve. Defaults to 1."
              },
              {
                "name": "max_page",
                "value": "3",
                "type": "query",
                "description": "Retrieve multiple result pages in a single API request. Specifies the maximum page number to retrieve."
              },
              {
                "name": "safe",
                "value": "active",
                "type": "query",
                "description": "Safe search filter setting."
              },
              {
                "name": "nfpr",
                "value": "0",
                "type": "query",
                "description": "Exclude auto-corrected spelling results. Set to 1 to exclude, 0 to include (default)."
              },
              {
                "name": "filter",
                "value": "1",
                "type": "query",
                "description": "Toggle similar/omitted result filters. 1 enables filtering (default), 0 disables it."
              },
              {
                "name": "tbs",
                "value": "",
                "type": "query",
                "description": "Custom Google TBS parameter value for advanced filtering."
              },
              {
                "name": "uule",
                "value": "",
                "type": "query",
                "description": "Custom Google UULE parameter to override the location."
              },
              {
                "name": "time_period",
                "value": "last week",
                "type": "query",
                "description": "Filter results by time period."
              },
              {
                "name": "time_period_min",
                "value": "01/01/2024",
                "type": "query",
                "description": "Custom time period start date in MM/DD/YYYY format. Required when time_period=custom."
              },
              {
                "name": "time_period_max",
                "value": "12/31/2024",
                "type": "query",
                "description": "Custom time period end date in MM/DD/YYYY format. Required when time_period=custom."
              },
              {
                "name": "sort_by",
                "value": "relevance",
                "type": "query",
                "description": "Sort news results by relevance or date."
              },
              {
                "name": "show_duplicates",
                "value": "",
                "type": "query",
                "description": "Display duplicate results when sort_by=date is used."
              },
              {
                "name": "exclude_if_modified",
                "value": "",
                "type": "query",
                "description": "Exclude results from queries that were modified by Google."
              }
            ]
          },
          "docs": "Retrieve real-time Google News results for a given keyword. Set search_type=news. Supports time period filtering, language, country, and sorting."
        }
      ]
    }
  ],
  "bundled": true
}