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
  • Nimble API Structure
  • WebAPI Overview
  1. Nimble SDK
  2. Web API
  3. Nimble Web API Quick Start Guide

Introduction

PreviousNimble Web API Quick Start GuideNextNimble APIs Authentication

Last updated 7 months ago

Nimble API Structure

At the core of the Nimble API is the – a generic API that accepts any public URL and collects data from that address. The Web API is designed to be flexible and support any use case while providing fundamental and advanced tools for robust web data pipelines.

The Web API also serves as the infrastructure for Nimble API Templates, which act as specialized APIs for specific use cases. Templates allow for specific goals to be met more accurately, provide an optimized workflow, or include use-case-specific functionality that wouldn’t apply outside the context of that particular implementation.

To help you get started, we created several Templates that can be used both as models for the development of your own apps, as well as in production-level data pipelines:

The Templates are based on the Web API, and their structure, workflow, and authentication process are fundamentally the same. Therefore, for the purposes of this quick-start guide, we’ll be going over the basics of using the Web API.

WebAPI Overview

The Web API is mainly operated through three major endpoints, each of which serves one of the three request types supported by the API. Each of these requests provide unique benefits in different situations.

  • Real-time request – The data request is performed immediately, and the result of the request is returned directly to the client that made the request.

  • Asynchronous request – the data request triggers an asynchronous task, and a taskID is returned to the client. The requested data is collected and delivered to a cloud storage repository, and a callback URL is notified when the task is completed.

  • Batch request – Batch requests are functionally identical to asynchronous requests, but can include up to 1,000 tasks (URLs) in a single batch.

Despite their differences, real-time, asynchronous, and batch requests all support the same fundamental parameters, which include:

URL – The address of the desired web data. The WebAPI supports any public web data, and automatically employs fingerprinting technology and other advanced countermeasures to ensure smooth access is achieved every time.

Location – WebAPI requests are always made through Nimble IP, our premium proxy network. Nimble IP offers granular global location targeting, and supports Country, City, and US State levels of selection. The desired locale can also be set for further accuracy when using a particular location.

Parsing – Instead of simply returning the HTML contents of the requested URL, Nimble API can parse the HTML into a structured JSON format that simplifies storage and expedites analysis. Additionally, Nimble API uses AI models to recognize and extract key data points, such as the price of a product, position of a listing in a SERP, and more.

Rendering – Controls the execution of javascript and other web technologies when loading the target URL. Some data sources will not require rendering, and in such cases disabling rendering reduces the response time for a faster request. However, many websites will require full javascript rendering to load properly and accurately.

In addition to those listed above, the WebAPI supports several additional parameters. For a complete list, see the .

SERP API
E-Commerce API
Maps API
Nimble API Functions Documentation
Web API