Retrieve Analyze

Analyzes a web page URL to extract structured data such as articles, products, images, etc., using the Analyze API with GET method.

byDiffbot Extract API (Web Extraction)

Web Scraping

4000+calls

11523mslatency

100.0%success rate

Updated: Oct 27, 2026, 12:32 AM

Continue setup in your AI

Only public catalog IDs and a safe return path are handed to the Plugins page. This does not run the tool or confirm current availability, authorization, price, limits, or upstream status; those conditions are checked again before execution.

Selected tool: diffbot.analyze.retrieve.v1
Provider scope: Diffbot Extract API (Web Extraction)
Catalog updated: 2026-10-27T00:32:17.444465+00:00
Business task: Media & Video Transcripts

Continue setupYou can return to this tool page if the selection is incomplete or expires.

Run on this page: Execute is the in-site test path. Continue setup is for adding the public selection to an external AI; the two paths are tracked and validated separately.

Discover -> Inspect -> Call

Call setup

Tool IDdiffbot.analyze.retrieve.v1

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

urlstringRequired

Web page URL of the analyze to process (URL encoded)

modestringOptional

By default the Analyze API will fully extract all pages that match an existing Extract API. Set mode to a specific Extract API (e.g., `mode="article"`) to extract content only from that specific page-type. All other pages will simply return the default Analyze fields.

fallbackstringOptional

If an appropriate API cannot be determined (pages classified with type "other"), fall back to this API.

fieldsstringOptional

Specify optional fields to be returned from any fully-extracted pages (e.g. `fields=querystring,links`)

discussionbooleanOptional

Pass `discussion=false` to disable automatic extraction of comments or reviews from pages identified as articles or products. This will not affect pages identified as discussions.

timeoutintegerOptional

Sets a value in milliseconds to wait for the retrieval/fetch of content from the requested URL. The default timeout for the third-party response is 30 seconds (30000).

callbackstringOptional

Use for jsonp requests. Needed for cross-domain ajax.

proxystringOptional

Specify an IP address of a [custom proxy](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies) that will be used to fetch the target page. (Ex: `&proxy` or `&proxy=0.0.0.0`)

proxyAuthstringOptional

Used to specify the authentication parameters that will be used with a custom proxy specified in the &proxy parameter. (Ex: `proxyAuth=username:password`)

useProxystringOptional

Set to `default` to use [Diffbot's datacenter proxy](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies) for this request. `none` will instruct Extract to not use proxies, even if proxies have been enabled for this particular URL globally.

Continue setup in your AI

Selected tool

diffbot.analyze.retrieve.v1

Provider scope

Diffbot Extract API (Web Extraction)

Catalog updated

2026-10-27T00:32:17.444465+00:00

Business task

Media & Video Transcripts

Continue setupYou can return to this tool page if the selection is incomplete or expires.