Web Data API Directory: Scraping, Search, Browsers & IP Intelligence

JSON

Delivery

The technical reference documents a key-authenticated HTTP API with JSON output. Its v1 schema differs from the current product-tier examples.[1][2]

Location data

Country, region, city, postal code, coordinates and timezone appear in the reference and product examples. Their nesting and field names differ between those sources.[1][2]

ASN and network

Current Starter examples include ASN fields; Standard adds company information. The v1 reference separately documents ASN, ISP, organization and connection type.[1][2]

Privacy signals

Current Professional examples show separate VPN, proxy, Tor, hosting and relay flags. The v1 reference defines security.is_vpn as VPN or proxy combined; confirm the schema supplied by the chosen plan.[1][2]

Access and free use

An IP Geolocation API key is required. Pricing documents 1,000 free monthly requests at 1 request per second, with no card. Free commercial-use permission is not explicit in the reviewed terms.[1][3][4]

Billing unit

Each API is billed separately by request subscription, with overage and possible automatic-upgrade terms. Public pages disagree on paid quotas and rate limits, so reconcile the applicable paid quote before purchase.[3][2][4]

IP versions

The v1 technical reference accepts both IPv4 and IPv6 in ip_address; omitting the parameter uses the caller's address.[1]

Free evaluation fields

The pricing FAQ says the free IP plan includes security and company fields. That statement does not resolve the differences between its current product examples and the linked v1 reference.[3][1][2]

Each Abstract API has its own request subscription. Free IP Geolocation documents 1,000 monthly requests at 1 request per second. Current paid quotas, rate limits and prices are not quoted here because the public pages disagree.

JSON

Delivery

The IP Geolocation package offers key-authenticated REST APIs with JSON responses. Its plans also include GraphQL access.[1][2][3]

Location data

The full endpoint documents country, city, locality, postcode, coordinates and timezone, plus a confidence level and estimated confidence-area polygons.[1]

ASN and network

The network object includes BGP prefix, registration context and announcing carrier ASNs, with upstream-carrier information when available.[1]

Privacy signals

The full endpoint's Hazard Report includes known proxy, VPN and Tor flags, hosting likelihood, cellular, iCloud Private Relay and blocklist indicators. Package plans, including Base, provide all endpoint fields.[1][2]

Access and free use

The IP Geolocation package requires an account API key, including its free 10,000-request monthly Base tier. No card is needed. Terms limit Base Access to one account per organization.[3][2][4]

Billing unit

Plans meter requests monthly. Bronze is USD 29.95/month for 100,000 requests, excluding tax; optional overages are USD 2.995 per 10,000 requests.[2]

IP versions

The full endpoint accepts IPv4 and IPv6 input addresses.[1]

Free API package distinction

The separate no-key Free APIs package is intended for browser/client calls. Its access model is different from the key-based IP Geolocation Base tier.[3][4]

The IP Geolocation package uses monthly request quotas. Base includes 10,000 free requests; Bronze includes 100,000 for USD 29.95/month, with optional overage pricing. All package fields are available at each tier.

browser session

Framework support

Official documentation lists Playwright, Puppeteer and Selenium.[1]

Managed infrastructure

The service handles proxy rotation, browser fingerprints, CAPTCHA handling and session recovery.[1]

PAYG rate

The public PAYG plan lists USD 8 per GB with no monthly commitment and built-in proxies and unlocking.[3]

Concurrency

The public pricing page advertises unlimited concurrent sessions.[3]

Setup

Create a Browser API zone and retrieve its connection details from the Overview tab.[2]

Transferred traffic in GB on paid plans; built-in proxy management and unblocking included.

JSON, HTML

Result format

Add brd_json=1 to the search URL for parsed JSON; the REST example otherwise returns HTML.[1]

Asynchronous delivery

Enable asynchronous requests on the SERP zone, submit with async=1, then retrieve using the response ID.[1]

Billing

Failed requests are not charged. In asynchronous mode, collection calls are free.[2][1]

PAYG rate

The public PAYG plan lists USD 1.50 per 1,000 requests, without a monthly commitment.[2]

Successful requests; asynchronous result collection is not separately billed.

browser session

Custom proxies

Supports custom HTTP/HTTPS proxies, built-in residential proxies and domain-based routing rules.[1]

Location behavior

Built-in proxy geolocation is best effort; the closest available location may be used.[1]

Billing increments

Browser time is billed by the minute and proxy traffic by the MB, with a one-minute and one-MB minimum per session.[2]

Concurrency

Current published limits are 3 sessions on Free, 25 on Developer and 100 on Startup.[2]

Reconnection

A timeout extends duration but a normal session ends on disconnect; keepAlive enables reconnection.[3]

Browser time plus built-in proxy traffic, with plan allowances and overages.

browser session

Time metering

Each started 30-second browser interval costs one unit, including idle time.[1]

Built-in proxy costs

Residential traffic costs 6 units per MB and datacenter traffic 2 units per MB, in addition to browser time.[1]

Custom proxy costs

Third-party proxies configured through --proxy-server do not consume Browserless proxy units; their own provider may bill separately.[1]

Failures

Pre-start validation or queue rejections consume no browser units; failures after startup consume elapsed time and transferred proxy traffic.[1]

Session timeout

The documented default timeout is 30 seconds; a custom timeout can be set on the connection.[1]

Units for browser time, built-in proxy bandwidth and successful CAPTCHA solves.

HTML, JSON

Token types

Normal tokens fetch static responses; JavaScript tokens enable browser rendering. javascript=true can switch a normal-token request to the JavaScript path.[1]

Browser controls

JavaScript requests support page_wait, ajax_wait, scroll and css_click_selector.[1]

Extended scrolling

The first 8 seconds of page-load plus scrolling count as one request; each additional started 5-second interval adds one billed request.[1]

HTTP-method limitation

POST is supported with the normal token only; JavaScript-rendered requests use GET.[1]

Successful requests; JavaScript request configuration and extended scrolling affect billed usage.

JSON, csv, mmdb

Delivery

JSON API and downloadable CSV/MMDB databases, with separate Lite and paid database editions.[1][2][3]

Location data

The Free API returns country, state/province and city. Basic adds detailed location fields including coordinates, postal code and timezone.[4][5]

ASN and network

Core adds ASN/name, ISP, organization and connection type to Basic location data. Basic does not include those network fields.[6][5]

Privacy signals

Extended adds proxy/crawler detection and threat assessment. Its proxyType field distinguishes HTTP proxies, VPNs and Tor; these security fields are not part of Basic or Core.[7][6][1]

Access and free use

The Free API permits 500 daily requests. Paid keys provide the fields and daily allowance of the selected plan. Lite databases use CC BY 4.0 attribution terms, including a backlink for web applications using their results.[4][1][3]

Billing unit

Paid API plans have daily query quotas that reset at midnight CET according to the FAQ; requests beyond the limit return an error. Database licensing is separate.[7][8][9]

IP versions

The API accepts IPv4 and IPv6, and the downloadable database catalog covers both.[1][2]

Lite versus paid database rights

Lite downloads may be used commercially under their attribution license. Paid database licenses permit internal use across the licensee's infrastructure and prohibit redistribution or competing lookup services.[3][8][9]

Browser API access

Paid API users can enable a separate public key for browser requests; the private key is used for server-side access.[1]

Paid API subscriptions combine a feature tier with a daily query allowance. Local databases have separate licenses; a daily API allowance is not a monthly lookup pool.

HTML, JSON

HTTP integration

The official Dify guide sends POST requests to https://scraper-api.decodo.com/v2/scrape using Basic authentication and a JSON body.[1]

JavaScript rendering

The documented payload uses headless=html to receive HTML after rendering.[1]

Proxy selection

The request can select proxy_pool=premium.[1]

Cost model

The current pricing page separates standard and premium proxies, with and without JavaScript rendering.[2]

Request credits vary by request complexity, including proxy pool and JavaScript rendering.

markdown, HTML, JSON, screenshot

Known page or whole site

POST /v2/scrape reads one URL. For a site traversal, /v2/crawl starts an asynchronous job. Give crawl an explicit page limit and path scope before starting.[1][5]

Markdown response

Request formats: ["markdown"]. Raw HTTP returns content in data.markdown inside a success/data envelope; SDKs return the data object directly.[1]

HTML choices

Use formats: ["html"] for cleaned page HTML at data.html. Use formats: ["rawHtml"] for unmodified page HTML at data.rawHtml. These formats preserve markup; Markdown is the text-oriented choice.[1]

Structured fields

Use a formats object with type: "json" and a prompt or JSON Schema for fields from a known page. Raw HTTP returns the extracted object at data.json. A JSON response envelope alone does not request extraction. Agent is a separate choice when source URLs must be discovered.[1][2]

Freshness

The documented cache default permits data up to two days old. Set maxAge: 0 when the task needs a fresh fetch; this does not guarantee that the target returns the desired page.[1]

Accepting the response

An API HTTP 200 or success: true is not sufficient. Inspect data.metadata.statusCode and the requested content: a captured target 403 or 404 can be returned and billed.[1][3]

Credit decision

For an ordinary returned page, Markdown uses the 1-credit base. JSON extraction totals 5 credits before other options. Extra modifiers stack; optional browser sessions have a separate billing basis.[3][2]

No-document exceptions

Ordinary scrapes that return no document generally cost 0 credits. Paid guards, threat scans and other documented options have exceptions; a returned error page is still a document.[3]

Authentication and capacity

Anonymous Scrape has daily per-IP limits. An account API key uses the team plan and shared request limits. Crawl, Map and batch requests require authentication.[4]

Rate limits versus target errors

A Firecrawl 429 can mean request-rate or concurrency limits. Inspect the response, respect Retry-After when provided and reduce load; repeating a captured target error is a separate decision.[4][6]

Credits per returned page, with option charges. An ordinary scrape is 1 credit; schema-guided JSON adds 4. Account plans and anonymous limits are separate. Check detailed billing before enabling extra options.

JSON, jsonp, xml, csv, text, php

Delivery

Hosted API with JSON/JSONP, XML, CSV, text and PHP output options, plus batch queries.[1]

Location data

Country, region, city, postal code, coordinates and timezone fields are documented.[2]

ASN and network

ISP, organization, ASN/AS name, mobile and hosting fields. ASN fields can be empty for address blocks not announced in BGP tables.[2]

Privacy signals

The proxy boolean combines proxies, VPNs and Tor exit addresses. A separate hosting boolean covers hosting, colocation and datacenter addresses.[2]

Access and free use

The free endpoint needs no key, uses HTTP and permits non-commercial use at 45 requests per minute per caller IP. Pro adds commercial use, API keys and HTTPS.[2][3][1]

Billing unit

Pro advertises unlimited requests subject to its acceptable-use policy. The listed €13.3/month price is a monthly equivalent when paying for 12 months, excluding VAT.[1]

IP versions

A query can be an IPv4 address, IPv6 address or domain name.[2]

Rate-limit handling

The free endpoint returns X-Rl for remaining requests and X-Ttl for reset time. At zero remaining requests, stop until reset; repeated excess can cause a one-hour ban.[2]

Pro is a fixed-term subscription advertised with unlimited queries subject to acceptable-use rules. The displayed €13.3 monthly equivalent requires payment for 12 months and excludes VAT.

JSON, xml, csv, bin, cidr

Delivery

Local IP2Location and IP2Proxy databases, plus the IP2Location.io JSON/XML API. The legacy IP2Location Web Service no longer accepts new registrations.[1][2][3][4]

Location data

The .io Free response includes country, region, city, postal code and coordinates. Local database fields depend on the DB package; API coordinates fall back to a capital-city coordinate when the city is unknown.[3][1]

ASN and network

The .io Free response includes ASN and AS name. Starter adds ISP, domain and usage type. Local database packages differ; the catalog includes ASN in DB26.[3][1]

Privacy signals

IP2Proxy is the related detection database family. In .io, Free and Starter detect public proxies; Plus adds VPN, Tor and residential-proxy classes; Security adds detailed proxy and datacenter fields.[2][5]

Access and free use

The .io API documents 1,000 keyless queries daily or 50,000 monthly on its keyed Free plan; both require attribution. LITE database downloads require a free account and are advertised for personal or commercial projects.[3][5][6]

Billing unit

The .io API counts queries within a monthly plan and adds paid overage blocks. Database subscriptions depend on package and license: Standard covers one server for internal use; Site covers controlled servers for internal use.[5][1][7]

IP versions

The current IP2Location.io API accepts IPv4 and IPv6. Confirm address-family coverage for the particular database edition before selecting local files.[3]

Database formats

The LITE comparison lists CSV, BIN and CIDR formats. Geolocation, IP2Proxy detection and ASN are distinct LITE downloads.[6]

Redistribution rights

The Master License Agreement distinguishes Standard and Site internal-use licenses from a separate Redistribution License.[7]

Legacy API migration

The legacy Web Service page directs new API customers to IP2Location.io. Its old trial and credit packages should not be used to plan a new integration.[4]

IP2Location.io has monthly API query allowances with paid overage blocks. Local database prices are annual and vary by data package and license; API access and database licenses are separate choices.

JSON, jsonp, xml, csv, yaml, plaintext

Delivery

Hosted location API with JSON, JSONP, XML, CSV and YAML responses. Single-field endpoints return plain text.[1]

Location data

City, region, country, postal code, coordinates and timezone, with additional country, currency and language metadata.[1]

ASN and network

ASN and organization are documented fields. Hostname is an optional beta add-on requiring separate enablement.[1]

Privacy signals

The inspected field reference documents location and ASN data; it does not document proxy, VPN or Tor detection fields.[1]

Access and free use

The free trial is for testing/development and is not for production use. Paid signup supplies a token that is included in the API query string.[2]

Billing unit

Plans count monthly IP lookups; each repeated lookup of the same address counts again. The entry plan lists 60,000 lookups for $15/month plus tax or $144/year.[2]

IP versions

The API documents both IPv4 and IPv6 support.[1]

Vendor identity

ipapi.co is provided by Kloudend Inc. It is a separate service from APILayer's ipapi.com.[3][4]

Response retention

Terms dated 28 January 2026 limit data retention to the minimum necessary for immediate use, capped at 24 hours, and prohibit persistent copies, databases or archives.[3]

Paid plans provide monthly lookup allowances with monthly or annual billing. Repeated queries for the same IP count separately; the free trial is for testing and development.

JSON, xml, jsonp

Delivery

Hosted API with JSON/XML output and optional JSONP callbacks, including standard IP, origin IP and bulk lookup endpoints.[1]

Location data

Country, city, postal code and coordinates are documented. Current pricing lists timezone and currency data from Standard onward.[1][2]

ASN and network

ASN and ISP information are documented connection data. The current plan table includes Connection Data from Standard.[1][2]

Privacy signals

Documentation describes optional Tor/proxy security data. The current plan table lists Security Data on Business Pro and Custom; lower paid tiers do not list that module.[1][2]

Access and free use

Signup provides an access_key. Free lists 100 lookups and non-commercial use; Standard and higher explicitly permit commercial use. The free allowance's reset interval is not stated clearly.[1][2][3]

Billing unit

Paid plans have monthly lookup counts and a per-call charge above quota. Standard lists 50,000/month, Business 500,000 and Business Pro 2,000,000.[2][3]

IP versions

Standard IP lookup documents support for IPv4 and IPv6 addresses.[1]

Bulk access

Bulk lookups require Business or a higher plan in the current documentation and pricing table.[1][2]

Vendor identity

ipapi.com is an APILayer product, distinct from Kloudend's ipapi.co.[3][4]

Optional support charge

The FAQ describes Platinum Support as optional, billed annually and initially selected during plan purchase; review this selection alongside the API subscription.[3]

Paid subscriptions have monthly lookup allowances and plan-specific per-call overage charges. Annual billing is available; optional Platinum Support adds a separate annual charge.

JSON

Delivery

HTTPS JSON API with global and EU endpoints. Enterprise pricing lists data downloads; their formats and dataset entitlements require confirmation.[1][2]

Location data

City, region, country, continent, postal code and approximate coordinates are documented, alongside timezone fields. Coordinates may be near a population center.[3]

ASN and network

Basic ASN fields include AS number, organization name, domain, network route and usage type. Company data is listed on Startup and Business plans.[3][2]

Privacy signals

Documents Tor, proxy, datacenter and iCloud-relay flags. VPN detection is restricted to Business and Enterprise; is_anonymous is defined as Tor or proxy.[3][2]

Access and free use

Requests require an API key. The free tier permits 1,500 requests daily for non-commercial use; choose a paid plan for commercial use.[1][2]

Billing unit

Plans specify daily request quotas. Paid bulk calls accept up to 100 IPs, with each IP counting as one request against the quota.[2][5]

IP versions

The official CLI documents lookup of both IPv4 and IPv6 addresses.[4]

EU endpoint

The vendor documents eu-api.ipdata.co with the same functionality, routing requests through its EU servers.[1]

Subscription plans have daily request quotas. Each IP in a bulk request consumes quota; the free 1,500-request daily tier is limited to non-commercial use.

JSON, xml, csv, mmdb

Delivery

HTTPS APIs with JSON or XML output, plus separately licensed database downloads. CSV and MMDB are standard database formats; other formats are available on request.[1][6][7]

Location data

Free includes country, region, city, postal code and coordinates when available. Paid plans add locality, estimated accuracy radius and location confidence.[2]

ASN and network

Free includes basic ASN fields. Paid plans add extended ASN, company and network information.[4]

Privacy signals

Paid IP Security documents separate proxy, residential-proxy, VPN, Tor, relay and cloud-provider flags. Security can be requested alone or added to geolocation; it is not part of the free plan.[3][4]

Access and free use

Most endpoints require an API key or authorized request origin. Free includes 1,000 daily credits and is restricted to noncommercial use by the terms.[1][4][7]

Billing unit

A base v3 lookup costs 1 credit, security alone 2, and base lookup plus security 3. Bulk uses the same module cost per valid IP. Starter includes 150,000 monthly credits for USD 19 billed monthly.[5][4]

IP versions

API lookups support IPv4 and IPv6 addresses.[1][4]

Credit accounting

Successful responses include X-Credits-Charged. The credits guide excludes malformed, private and bogon addresses from billable valid IPs.[5]

API usage is charged in module credits: a base lookup costs 1, security alone 2, and location with security 3 per valid IP. Paid plans include credits and bill overages; database subscriptions are separate.

JSON, plaintext, csv, mmdb, parquet

Delivery

HTTPS API and downloadable databases. Core database access requires a separate enterprise subscription; its self-service API plan does not include downloads.[1][3]

Location data

Lite returns country and continent. Core adds city, region, postal code, coordinates and timezone; Max adds an accuracy radius and change metadata.[2][3][4]

ASN and network

Lite returns ASN, organization name and domain. Core adds ASN type plus hosting, mobile, satellite and anycast flags; Max adds carrier details.[2][3][4]

Privacy signals

Core exposes a combined is_anonymous flag. Max adds separate VPN, proxy, Tor, relay and residential-proxy flags in the anonymous object. Lite has no privacy fields.[2][3][4]

Access and free use

An API token authenticates requests. Lite is free with unlimited country/ASN requests; the pricing page permits commercial use with attribution.[1][2][5]

Billing unit

Paid API allowances are monthly request counts. Metered billing permits paid overages; without it, exceeding the quota produces HTTP 429.[1][5]

IP versions

The API accepts IPv4 and IPv6 addresses and documents dual-stack access, with optional explicit v4 and v6 hostnames.[1]

Residential proxy history

Max API recency and activity fields use a rolling 7-day observation window; the Residential Proxy database uses a 30-day window.[4]

Paid APIs have monthly request allowances and optional metered overages. Lite has no request quota; paid database delivery is separate from self-service API plans.

JSON, xml

Delivery

API-key-authenticated JSON or XML lookup API, plus a separate downloadable/on-premise database offering. The reviewed database page does not specify a file format.[1][4]

Location data

Country, region, city, postal code, coordinates and timezone are documented when known. Fields can be N/A or null.[2]

ASN and network

ISP, organization, ASN and connection type are documented. Connection type can distinguish Residential, Corporate, Education, Mobile and Data Center.[2]

Privacy signals

Documents proxy, VPN, Tor, active VPN/Tor and fraud signals. Enriched fields including frequent_abuser, shared_connection and dynamic_connection are Enterprise data points; confirm other fields against the account's entitlement.[2]

Access and free use

API access requires an account key. The product advertises 1,000 free IP lookups per month; terms prohibit duplicate accounts for extra free credits and allow evaluation-access limits.[1][3][5]

Billing unit

Each lookup/request normally consumes one query credit, with specific exclusions. Paid subscriptions and prepaid packs are documented; a current paid-price table was not exposed in the reviewed plans page.[5][6]

IP versions

The API reference includes IPv4/IPv6 validation. The downloadable reputation database explicitly documents both address families.[1][4]

Suspected versus active flags

vpn can include datacenter ranges that could become active VPNs, and tor can include previously active nodes. active_vpn and active_tor are separate response fields.[2]

API lookups consume one query credit except documented exclusions. Subscriptions and prepaid query packs are offered; the product advertises 1,000 free monthly IP lookups. Current paid prices were not verified.

JSON, csv, mmdb

Delivery

Hosted JSON API and separately subscribed CSV/MMDB datasets for local lookup. The AS dataset is listed as CSV only.[1][2]

Location data

Country, region, city, postal code and approximate coordinates. Unknown field values are null; coordinates do not identify a household or street address.[1]

ASN and network

ASN, announcing route, network name and type, company details and mobile-carrier fields are documented.[1]

Privacy signals

Separate proxy, residential-proxy, VPN, relay, Tor-relay, Tor-exit and cloud-provider flags. Every API plan includes the full response; these fields are not reserved for a higher API tier.[1][3]

Access and free use

An account and API key are required. New accounts receive 20,000 free credits once, without a stated time limit; this is not a recurring monthly allocation.[4][3]

Billing unit

A single lookup uses one credit. Batch endpoints use one credit per lookup plus one for the batch request. Monthly allowances and non-expiring packs are separate purchasing options.[3]

IP versions

IP lookup fields document both IPv4 and IPv6 addresses.[1]

Tor and relay definitions

is_tor includes Tor exit relays, middle relays and bridges. Use is_tor_exit for exits specifically. The separate is_relay field currently covers Apple Private Relay.[1]

Offline licensing

Published dataset prices cover private internal use. Redistributing data to customers requires a separate custom license.[3]

API subscriptions supply monthly credits; one-time credit packs do not expire. Single lookups cost one credit, while batches cost one per lookup plus one. Offline datasets have separate subscriptions.

JSON, xml, csv, mmdb

Delivery

The free API uses ipwho.is and paid access uses ipwhois.pro, with JSON, XML or CSV output. Enterprise database downloads are offered separately in MMDB, CSV or JSON.[1][2][3]

Location data

Country, region, city, postal code and approximate coordinates are documented, alongside timezone fields.[1]

ASN and network

The connection object provides ASN, organization, ISP and domain.[1]

Privacy signals

Business and Unlimited provide proxy, VPN, Tor, hosting, relay and mobile fields when security=1 is requested. Free and Basic do not include security data.[1][3]

Access and free use

Free needs no signup or key, permits commercial use, and allows 1,000 requests per day per client IP. CORS requests share a limit by website domain. Paid access requires an API key.[1][2]

Billing unit

Basic is USD 19.99/month for 600,000 requests; Business is USD 39.99/month for 3 million. Business/Unlimited bulk calls cost one credit per IP, not one per batch.[3][4]

IP versions

Single lookups accept IPv4 and IPv6. Business/Unlimited bulk requests can mix both families, with up to 100 IPs per call.[1][4]

Error handling

HTTP 200 can still contain success:false for an invalid or reserved IP. Check the response body as well as HTTP status.[1]

Free has a daily request limit. Paid API plans have monthly allowances; bulk consumes one credit per IP. Enterprise database downloads require a separate sales arrangement.

markdown, text, HTML, JSON

Known URL first

Prefix a complete URL with https://r.jina.ai/ to read that page, for example https://r.jina.ai/https://example.com. The separately authenticated s.jina.ai search endpoint has its own terms.[1][2]

Main content or full page

The default content mode extracts readable page content as Markdown. X-Respond-With: markdown returns full-page Markdown without the readability filter. Use the default for an article body; choose full-page mode when surrounding page text matters.[2][3]

JSON wrapper versus fields

Accept: application/json requests a JSON response with page URL, title and content. It does not ask Reader to extract your own JSON Schema fields. X-Respond-With selects the content representation inside the response.[1][2][3]

HTML and text choices

Set X-Respond-With: html for HTML or X-Respond-With: text for plain text. Select the representation your application will process before comparing output size or token usage.[2][3]

Freshness

Use X-No-Cache: true or X-Cache-Tolerance: 0 when cached output is unsuitable. Published sources give different cache lifetimes, so do not rely on one universal default TTL.[1][2][3]

Missing dynamic content

For a page that needs browser rendering, explicitly choose X-Engine: browser. X-Wait-For-Selector waits for an expected element; X-Target-Selector limits returned content and X-Remove-Selector removes unwanted elements.[1][2][3]

Hash-based routes

A URL fragment after # is normally kept by the HTTP client. For a route such as https://example.com/#/route, POST the full URL in the request body to https://r.jina.ai/ so Reader receives the fragment.[2][3]

Reject or truncate

X-Token-Budget rejects a request when the resulting token cost would exceed the limit. X-Max-Tokens truncates returned content. Choose rejection when completeness matters; use truncation only when partial output is acceptable.[2][3]

Authentication and limits

Basic Reader requests can omit credentials. Send Authorization: Bearer YOUR_JINA_API_KEY for the supplied key’s token balance and rate limits. Anonymous limits are tracked by IP; keyed requests use the key’s limits.[1][3]

Basic anonymous URL reading is rate-limited. Keyed Reader usage draws from the supplied API key’s output-token balance; optional modes can change token usage. Jina documents no token deduction for failed requests. Check the current key quota and rate table.

JSON, mmdb, csv

Delivery

HTTPS JSON web services and local MMDB or CSV databases. GeoLite and Anonymous IP are separate datasets with different fields.[1][3][4]

Location data

Country and City editions provide different geographic detail. City data describes an area using coordinates and an accuracy radius; city and postal fields may be unavailable.[3]

ASN and network

GeoLite offers a separate ASN database. Web-service fields include ASN number, ASN organization and network; ISP and organization fields are not included in GeoLite City.[3][2]

Privacy signals

GeoIP Insights and the Anonymous IP database provide VPN, public-proxy, Tor-exit, hosting and residential-proxy signals. The API anonymizer object is Insights-only.[2][4]

Access and free use

An account and license key are required. GeoLite requires attribution and compliance with its EULA, including update and redistribution conditions. It permits internal business use subject to those terms.[1][5]

Billing unit

Paid web services use service credit for queries. Free GeoLite allows 1,000 lookups per day per service and 30 database downloads per day; Anonymous IP download pricing requires sales contact.[1][3][4]

IP versions

Web services accept IPv4 and IPv6 inputs. Anonymous IP CSV downloads contain separate IPv4 and IPv6 network files.[1][4]

Current API field location

Use anonymizer for Insights privacy flags. The matching traits flags are deprecated and retained for backwards compatibility.[2]

Database maintenance

The GeoLite EULA requires updated data and destruction of old versions within 30 days after a newer database release.[5]

Paid GeoIP web services require service credit. GeoLite has daily free limits; Anonymous IP database purchasing is arranged separately with MaxMind.

HTML, JSON, markdown, PNG

Formats

The formats array selects HTML, Markdown, Base64 PNG screenshots and response headers.[1]

Rendering

render defaults to false; true enables JavaScript and auto lets Nimble select the configuration.[1]

Parsing and actions

CSS parsing schemas, browser actions and network-capture rules are supported.[1]

Async processing

Async and batch submissions return before processing finishes; poll task or batch progress for completion.[2]

Billing

Extraction Tools are listed at USD 1 per 1,000 URLs, with charges only for successful requests.[3]

Successful URL extractions; public API pricing lists USD 1 per 1,000 URLs for Extraction Tools.

HTML, JSON, PNG

Authentication

Use a Web Scraper API user's username and password with HTTP Basic authentication, rather than dashboard credentials.[1]

Rendering and parsing

render=html enables JavaScript rendering. Dedicated supported targets accept parse=true for structured JSON.[1]

Delivery choices

Realtime keeps the connection open; Push-Pull retrieves jobs asynchronously; Proxy Endpoint offers a proxy interface.[2]

Batch size

Push-Pull accepts up to 5,000 query or URL values per batch; Realtime and Proxy Endpoint do not support batch.[2]

Screenshots

render=png returns a Base64-encoded screenshot.[2]

Product-specific plan and target rates; exact costs and failed-request rules were not verified in this pilot.

JSON

Delivery

HTTP JSON API. The v3 reference documents nested network, location and detection objects; some prose still calls v2 the latest version, so keep the API version explicit.[1][2]

Location data

The v3 OpenAPI schema lists country, region, city, coordinates and timezone. Missing values can be null.[2]

ASN and network

The v3 reference lists ASN, network range, hostname, provider, organization and allocation type.[1][2]

Privacy signals

The v3 schema lists proxy, VPN, Tor and hosting booleans, plus risk, confidence and detection timestamps. Pricing includes core detection features on Free; customization limits vary by plan.[2][1][3]

Access and free use

Keyless access allows 100 queries/day; a registered free key allows 1,000/day. Origin-bound public browser keys check only the requesting visitor's IP. One free account is allowed per customer.[1][4]

Billing unit

Each checked address consumes daily quota. The v3 service table allows up to 100 addresses per keyless request or 1,000 with a registered key. The daily allowance is separate from this batch limit.[1][3]

IP versions

The API documentation accepts IPv4 and IPv6 inputs, including multiple-address requests.[1]

Risk and confidence

Risk includes a baseline related to detected usage type and attack history. Confidence emphasizes recency of positive detections; it is a separate field.[1][2]

Data reuse

Terms permit selected data to enrich a service but prohibit republishing entire results, resale or a service whose main value is access to the data.[4]

Subscriptions buy daily query allowances even when billed monthly or yearly. Every checked address consumes quota, including addresses sent in bulk. Registered free access permits 1,000 queries per day.

browser session

Session lifetime

sessionTTL defaults to 180 seconds. The guide recommends a maximum of 900 seconds while noting longer values can be set.[1]

Custom proxies

proxyURL accepts a custom proxy and overrides other proxy parameters; this feature requires a subscription.[1]

Recording

sessionRecording enables replay of a completed session and is disabled by default.[1]

Frameworks and state

Playwright and Puppeteer are supported; Profiles provide login-state reuse with configurable persistence.[2]

Billing dimensions

The Crawl introduction states its runtime-plus-proxy-bandwidth billing model is shared with Browser.[3]

Browser runtime and proxy bandwidth; exact plan-specific rates were not verified.

HTML, JSON, markdown, screenshot

Billing outcomes

The credit policy counts both HTTP 200 and 404 responses as successful, billable requests.[1]

Rendering costs

Standard rendering costs 10 credits; residential plus rendering costs 25; render_js_cheap costs 5 using a limited provider set.[1]

Extraction add-on

llm_extract adds 25 credits on top of base proxy costs.[1]

Cheaper rendering tradeoff

render_js_cheap is intended for simpler sites and does not provide the full upstream provider pool.[2]

Response options

The feature list documents screenshot capture and JSON or Markdown LLM extraction responses.[3]

Monthly API credits determined by target and options; HTTP 200 and 404 responses consume credits.

HTML, JSON

Rendering

render=true returns HTML after JavaScript execution; wait_for_selector requires rendering.[1]

Credit examples

The documented parameter table lists 10 credits for rendering, 25 for premium plus rendering, and 75 for ultra-premium plus rendering.[2]

Billable outcomes

HTTP 200 and 404 responses are charged, as are client-cancelled requests when the client allows less than 70 seconds.[2]

Cost inspection

The account/urlcost endpoint estimates request cost and the sa-credit-cost response header reports actual credits.[2]

Concurrency

Concurrency is plan-dependent; the Async API supports batch requests.[3]

Structured extraction

autoparse=true and dedicated structured-data endpoints parse supported sites and target types; ordinary URL fetching is not a universal field-extraction contract.[1][4]

API credits determined by target domain and request options.

HTML, JSON, screenshot

Rendering and actions

render_js enables browser rendering; js_scenario defines page interactions before results return.[1]

Result handling

Examples return scraped content and browser data through the API result rather than exposing a browser connection.[1]

Credit model

A scrape can consume multiple credits depending on browser, proxy and protection configuration.[2]

Concurrency examples

Published monthly plans list 5 concurrent requests for Discovery, 20 for Pro, 50 for Startup and 100 for Enterprise.[2]

Quota expiry

Unused subscription quota does not roll over to the next subscription period.[2]

Integrated extraction

extraction_model, extraction_prompt and extraction_template select documented model, prompt and template extraction approaches within a scrape.[3]

API credits per scrape; proxy network, rendering and protection settings affect consumption.

HTML

Rendering and response

The /v2/general endpoint returns plain HTML. browser defaults to true; return_page_source skips JavaScript rendering while using the browser.[1]

Timeout

Request timeout defaults to 60 seconds and can be set from 5 to 60 seconds.[1]

Credit examples

Simple datacenter requests cost 1 credit; JavaScript-rendered datacenter requests cost 10; rendered residential requests cost 125.[2]

Usage inspection

The Ant-credits-cost response header reports request credit consumption; unused credits expire at the subscription boundary.[2]

API credits based on browser use and proxy network.

JSON, HTML

Authentication

Send the API key as an Authorization Bearer token.[1]

Request mode

light_request defaults to true. Light mode omits the browser and may return less data; disabling it selects regular mode.[1]

Search controls

Select country, desktop/mobile device and search type. News search is not supported with mobile device selection.[1]

HTML and pagination

add_html can include page HTML. The pages parameter supports up to ten pages; the provider recommends at most three for reliability.[1]

Documentation distinguishes light requests at 10 credits from regular requests at 15 credits. Confirm the selected mode; credits are not USD.

HTML, JSON, markdown, text, screenshot

Rendering default

render_js defaults to true. HTML, page text, Markdown and screenshots are documented output options.[1]

Request credits

Classic requests cost 1 credit without rendering or 5 with it; premium with rendering costs 25 and stealth with rendering costs 75.[1]

Extraction and interaction

CSS extract_rules and js_scenario support structured extraction and page interactions.[1]

Custom proxy

The own_proxy parameter supports a user-supplied proxy provider.[1]

Automatic cost control

GET-only mode=auto chooses a successful rendering/proxy tier; max_cost caps eligible tiers and all-failed auto attempts cost zero.[1]

Monthly API credits; rendering and proxy tier determine base credits, with AI extraction add-ons.

browser session

Default session

The configuration guide specifies a desktop, headful session with a five-minute timeout; proxies and CAPTCHA solving are off by default.[1]

Custom proxies

Use useProxy.server or proxyUrl; proxyUrl takes precedence over useProxy.[1]

Idle release

inactivityTimeout can release a session before its total timeout; CDP commands and remote input reset the idle timer.[1]

Stored state

sessionContext supplies cookies/storage, while profiles preserve browser state across sessions.[1]

Browser connection

Attach Playwright or Puppeteer using the session ID and API key on the Steel WebSocket endpoint.[2]

Session time; exact plan rates and proxy add-on prices were not verified.

HTML, PNG

Request interface

The official example posts form-encoded fields to universalapi.thordata.com/request with a Bearer token.[1]

Rendering

js_render=True enables JavaScript rendering for dynamic content.[1]

Output

The type parameter selects HTML or PNG; HTML is the documented default.[1]

Resource controls

block_resources restricts fetched resources; country selects the scraping proxy location.[1]

Not verified; request multipliers, failed-request billing and plan pricing require further evidence.

HTML, JSON, screenshot

HTTP output

httpResponseBody=true returns the response body Base64-encoded; decode it before parsing.[1]

Browser output

Browser requests return rendered HTML, screenshots or both, and support browser actions and network capture.[2]

Structured extraction

The API supports dedicated extraction types including articles, products, job postings and SERPs.[3]

Billing

Unsuccessful and rate-limited responses are free; browser actions, screenshots and extraction can add costs.[4]

Request model

The /v1/extract endpoint blocks until its single-URL result is ready.[3]

Successful responses, priced by target and HTTP/browser tier, with feature add-ons.

browser session

Connection

The CDP endpoint accepts Playwright, Puppeteer and other CDP-compatible libraries.[1]

Session lifetime

ttl defaults to 60 seconds and accepts values from 15 to 3,600 seconds.[1]

Billing

Session units are the larger of navigation count and duration rounded up to 15-second intervals, using the first target's browser price tier.[1]

Continuity

A connection has its own IP and cookie jar; separate CDP connections cannot reuse that session automatically.[1]

Access requirements

CDP requires a subscription or PAYG spending limit plus business verification; free trials cannot use it.[1]

Target-tier units: the greater of page.goto calls or started 15-second session intervals; residential overages can add charges.

JSON, HTML

Endpoint and authentication

POST to /v1/search using the API key as the Basic-auth username and an empty password.[1]

Output selection

The include option selects organic results, HTML or both. Parsed results carry rank, title and URL; snippet is optional.[3][1]

Result quantity

maxResults accepts multiples of ten from 10 to 100, with a default of 10. Request weight increases with result count.[2]

Targeting

Use engine-native query parameters or generic geolocation and locale options. Unsupported search domains return HTTP 400.[2]

Request weight increases with maxResults: max(1, maxResults / 10). A USD rate was not established from the reviewed search documentation.