LogoLogo
Nimble HomeLoginCreate an Account
  • Home
  • Quick Start Tutorials
    • Tutorial Library
      • Track SEO and SEM Ranking
      • Reddit as a Guerilla Marketing Strategy
  • Nimble Platform
    • Nimble Platform Overview
    • Online Pipelines
      • Supermarkets
        • ASDA
        • Tesco Groceries
        • Sainsbury’s
        • Morrisons
      • eCommerce
      • Restaurants
        • Yelp
        • Tabelog
        • Uber Eats Japan
        • Demaecan
        • Uber Eats US
      • Real Estate
        • Zillow
  • Nimble SDK
    • SDK Overview
    • Web API
      • Web API Overview
      • API Product Specs
      • Nimble Web API Quick Start Guide
        • Introduction
        • Nimble APIs Authentication
        • Real-time URL request
        • Delivery methods
        • Batch processing
        • Response codes
        • FAQs
      • Nimble Web API Functions
        • Realtime, Async & Batch Request
        • Geo Location Targeting
        • Javascript Rendering
        • Page Interaction
          • Wait (delay)
          • Wait for Selector
          • Wait and Click
          • Wait and Type
          • Scroll
          • Scroll to
          • Infinite Scrolling
          • Capturing Screenshots
          • Collecting Cookies
          • Executing HTTP Requests
          • Operation Reference
        • Network Capture
          • Filter by URL Matching
          • Filter By Resource Type
            • Real World Demo: Capturing Ajax Requests
          • Wait for Requests
          • Capturing XHR without Rendering
          • Operation Reference
        • Data Parsing
          • Parsing Templates
          • Merge Dynamic Parser
        • Custom Headers & Cookies
        • General Params
      • Vertical Endpoints
        • SERP API
          • Real-time search request
          • Getting local data
          • Browsing SERP pagination
          • Delivery methods
          • Batch Processing
          • Endpoints and Response Codes
        • Maps API
          • Searching for places
          • Getting information about a place
          • Collecting reviews
          • Delivery methods
          • Batch processing
          • Endpoints and Response Codes
    • Web Retrieval API
      • Web Retrieval API Overview
    • Proxy API
      • Nimble IP Overview
      • Nimble IP Quick Start Guide
        • Send a request
        • Nimble IP Autentication
        • Geotargeting and session control
        • Response codes
        • FAQs
      • Nimble IP Functions
        • Country/state/city geotargeting
        • Controlling IP rotation
        • Geo-sessions: longer, stickier, more accurate sessions
        • Using IPv6 Proxies
        • Response Codes
      • Integration Guides
        • Incogniton
        • Kameleo
        • VMLogin
        • AdsPower
        • FoxyProxy
        • Android
        • Multilogin
        • iOS
        • SwitchyOmega
        • Windows
        • macOS
        • Proxifier
        • MuLogin
        • Puppeteer
        • Selenium
        • Scrapy
    • Client Libraries
      • Installation
      • Quick Start
    • LangChain Integration
  • Technologies
    • Browserless Drivers
      • API Driver-Based Pricing
    • IP Optimization Models
    • AI Parsing Skills
  • Management Tools
    • Nimble Dashboard
      • Exploring the User Dashboard
      • Managing Pipelines
      • Reporting and Analytics
      • Account Settings
      • Experimenting with the Playground
      • Billing and history
    • Nimble Admin API
      • Admin API basics
      • Admin API reference
  • General
    • Onboarding Guide
      • Getting started with Nimble's User Dashboard
      • Nimble IP Basics
      • Nimble API Basics
      • Helpful Resources
    • FAQs
      • Account Settings and Security
      • Billing and Pricing
      • Tools and Integrations
      • Nimble API
      • Nimble IP
    • Deprecated APIs
      • E-commerce API
        • E-commerce API Authentication
        • Real-time product request
        • Real-time product search request
        • Delivery methods
        • Batch Processing
        • Endpoints and Response Codes
      • Unlocker Proxy Overview
        • Unlocker Proxy Quick Start Guide
          • Real-time request
          • FAQs
        • Unlocker Proxy FAQ
Powered by GitBook
On this page
  1. General
  2. Product Updates
  3. 2024

September

Last updated 7 months ago

Nimble SDK Feature Updates

State & City geo-targeting via Nimble API

Description

Geo-targeting by City and State is now available via Nimble APIs. Previously exclusive to proxy users, this functionality is now accessible across all API endpoints with the new city and state parameters, in addition to the country parameter.

  • Available in , , and APIs

  • For more information, read .

Example Request

include the state and city fields in your API request. Make sure to refer to the list of provided by Nimble IP. For example:

curl --location --request POST 'https://api.webit.live/api/v1/realtime/web' \
--header 'Authorization: Basic <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://ipinfo.io/json",
    "country": "US",
    "state": "NY",
    "city": "brooklyn",
    "render": true
}'
Blocked Domains for Resource Loading

Description

Webpages typically load resources from many external domains, including iframes, images, javascript files, and other resources. In some cases, it may be beneficial to restrict non-essential resources in order to speed up the loading of a page, save bandwidth, and more.

This feature allow the user to prevent the external resources of a certain domains from being loaded while page is rendered, with the new blocked_domains parameter in render_options. This helps manage and block unwanted resources during page rendering

  • Available in .

  • For more information, read .

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/web' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.example.com",
    "method": "GET",
    "parse": true,
    "render": true,
    "render_options": {
        "include_iframes": true,
        "blocked_domains": ["example2.com", "example3.com"]
    }
}'
Website Cookies Collection

Description

Websites may set cookies for a variety of purposes, from identifying returning users to storing user preference information.

Capture dynamic cookies set by websites after page load with the new get_cookies parameter in render_flow. This allows you to collect cookies used for user identification and preferences.

  • Available in .

  • For more information, read .

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/web' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.example.com",
    "render": true,
    "render_flow": [{
        "get_cookies": {
                "timeout": 1000
        }
    }]
}'
Screenshot Format Support

Description

We’ve expanded our screenshot format options. Alongside the default PNG, you can now choose between PNG and WEBP base64 formats using the new format parameter in render_flow.screenshot

  • Available in .

  • For more information, read .

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/web' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.example.com",
    "render": true,
    "render_flow": [{
        "screenshot": {
                "full_page": true,
                "format": "jpeg",
                "timeout": 30000
        }
    }]
}'
Google News Tab in SERP API

Description

Google News Tab in SERP API: This feature allows users to directly access news-specific search results through the SERP API. By using the new tab parameter, you can specify that you want to retrieve results from the News tab in Google Search.

This is achieved using the standard Google Search URL format (e.g., www.google.com/search?q=olympics+2024&tbm=nws), rather than relying on news.google.com. This approach ensures more consistent and comprehensive news results directly from Google’s main search engine.

  • Available in

  • For more information, read .

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/serp' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_engine": "google_search",
    "country": "US",
    "query": "Sample search phrase",
    "tab": "news"
}'
Ads Optimization in SERP API

Description

This feature helps to increase the visibility of paid results (sponsored ads) in Google Search. It introduces a new Boolean parameter named ads_optimization, which enables users to optimize the number of ads returned.

The feature operates in "incognito mode" to avoid personalization and ensure the results are based solely on the ad content rather than user-specific search history.

  • Available in

  • For more information, read .

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/serp' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_engine": "google_search",
    "country": "US",
    "query": "Sample search phrase",
    "ads_optimization": true
}'
Google Maps Reviews Sorting in Maps API

Description

This feature introduces the ability to specify the sorting method for reviews when using the Google Maps reviews endpoint. A new parameter named sort is added to the google_maps_reviews search engine, allowing customers to choose how reviews are sorted.

The sort parameter is an enum with multiple options: relevant, newest, highest_rating, and lowest_rating. This allows clients to sort the returned reviews based on their preference.

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/serp' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_engine": "google_search",
    "country": "US",
    "query": "Sample search phrase",
    "ads_optimization": true
}'
Direct Access to XHR Requests

Description

We now support scraping internal XHR calls directly by passing them as the target URL with render set to false. Previously, network capture (with render set to true) was required for XHR data extraction. Use the new is_xhr Boolean parameter to specify if the target page is an XHR request.

Example Request

curl -X POST 'https://api.webit.live/api/v1/realtime/web' \
--header 'Authorization: Basic <credential string>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://www.lowes.com/wpd/5001374857/productdetail/1875/Guest",
    "country": "US",
    "is_xhr": true
}'

Available in .

For more information, read .

Available in .

For more information, read .

Web
SERP
Maps
eCommerce
related documentation
supported locations
Web API
related documentation
Web API
related documentation
Web API
related documentation
SERP API.
related documentation
SERP API.
related documentation
Maps API
related documentation
Web API
related documentation