Diffbot

diffbot

Diffbot provides AI-powered tools to extract and structure data from web pages, transforming unstructured web content into structured, linked data.

Artificial Intelligence AI Web Scraping Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (14)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Diffbot SearchDIFFBOT_DIFFBOT_SEARCHAcción

Tool to search data extracted by crawl or bulk jobs using dql queries. use after data extraction jobs complete to retrieve search results.

Parámetros de entrada

sizeinteger
Number of results to return (max 1000). If omitted, defaults to 10.
sortstring
Field name to sort results by; prefix with '-' for descending order.
querystringObligatorio
Structured search query in DQL format, specifying conditions to match documents.
fieldsstring
Comma-separated list of fields to include in the response; all if omitted.
offsetinteger
Offset for pagination (API param 'from'; default=0).
excludestring
Comma-separated list of fields to exclude from the response.
explainboolean
Return detailed query explanation (default=false).
indicesstring
Comma-separated list of indices to search (default="public").

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Diffbot Account DetailsDIFFBOT_GET_ACCOUNTAcción

Tool to retrieve account details, including plan information and usage statistics. use after authenticating to verify subscription and daily quota status.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Diffbot AnalyzeDIFFBOT_GET_ANALYZEAcción

Tool to automatically determine a page's content type and route it to the appropriate extraction api. use when you have only a url and need diffbot to choose the right extractor.

Parámetros de entrada

urlstringObligatorio
The full URL of the page to analyze, including http:// or https://
fieldsstring
Comma-separated list of fields to limit the output fields and reduce response size.
callbackstring
Optional JSONP callback function name. If set, the API returns JSONP-wrapped response.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Article DataDIFFBOT_GET_ARTICLEAcción

Tool to extract information from articles, including authors, publication dates, and images. use when you need structured metadata from a web article url.

Parámetros de entrada

urlstringObligatorio
Full URL of the web page to analyze, must start with http or https
modestring
Extraction mode override (defaults to 'article')
statsboolean
Whether to include statistics like word count
fieldsstring[]
List of specific fields to include in the response. If provided, only these fields are returned.
pagingstring
Paging token for multi-page articles (returned in previous response)
timeoutinteger
Maximum time in milliseconds to wait for page rendering
callbackstring
Name of the JSONP callback function (if using JSONP)
discussionboolean
Whether to include discussion/comment data in the response

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Discussion ThreadDIFFBOT_GET_DISCUSSIONAcción

Tool to extract threads of content from forums, comment sections, and review pages. use when you need structured discussion data from web pages after identifying the discussion url.

Parámetros de entrada

urlstringObligatorio
The URL of the discussion page to process.
fieldsstring
Comma-separated list of fields to include in the response.
maxPagesinteger
Maximum number of pages to concatenate; set to 'all' for all pages.
norenderboolean
Set to True to disable full page rendering for faster responses.
discussionboolean
Set to False to disable comment extraction.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Diffbot Get EventDIFFBOT_GET_EVENTAcción

Tool to extract event details from web pages. use when you need structured event data such as venue, date, and description.

Parámetros de entrada

urlstringObligatoriouri
URL of the event page to analyze
fieldsstring
Comma-separated list of fields to return, e.g., title,date,location
pagingboolean
Enable automatic paging of results
timeoutinteger
Maximum timeout in milliseconds for the API call
callbackstring
JSONP callback function name, if JSONP output is needed

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Diffbot Get ImageDIFFBOT_GET_IMAGEAcción

Tool to extract detailed information about images, including dimensions and recognition data. use after confirming the image url is publicly accessible.

Parámetros de entrada

urlstringObligatoriouri
Publicly-accessible URL of the image to analyze
fieldsstring[]
Comma-separated list or array of specific fields to include in response, e.g., 'naturalWidth','captions'
pagingboolean
Whether to include paging information for multi-image responses
timeoutinteger
Maximum time to wait for API response, in milliseconds

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Diffbot Get ProductDIFFBOT_GET_PRODUCTAcción

Tool to extract product information such as specifications, prices, availability, and reviews. use when you need structured product data including specs, pricing, and reviews.

Parámetros de entrada

urlstringObligatoriouri
URL of the product page to analyze
modestring
Extraction mode override (defaults to 'product')
fieldsstring[]
List of fields to return, e.g., title,offerPrice,images
pagingboolean
Enable automatic paging of results
timeoutinteger
Maximum timeout in milliseconds for the API call
callbackstring
JSONP callback function name, if JSONP output is needed
discussionboolean
Include discussions/comments in the response

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Video DataDIFFBOT_GET_VIDEOAcción

Tool to extract information from videos, including titles, descriptions, and embedded html. use when you need structured video metadata from any web page.

Parámetros de entrada

urlstringObligatorio
Full URL of the web page to analyze for embedded videos, must start with http or https
modestring
Extraction mode override (e.g., 'auto')
fieldsstring[]
List of specific fields to include in the response; if provided, only these fields are returned
pagingboolean
Whether to return all detected results in one call (may increase runtime)
timeoutinteger
Maximum time in milliseconds to wait for extraction
callbackstring
Name of the JSONP callback function (if using JSONP)
fallbackboolean
Whether to try an alternate extraction method if the primary fails
discussionboolean
Include user discussion data (comments) if available

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Bulk JobsDIFFBOT_LIST_BULK_JOBSAcción

Tool to list all bulk jobs associated with a specific token. use after authenticating to retrieve statuses of all jobs for the account.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Resolve Lost IDDIFFBOT_RESOLVE_LOST_IDAcción

Tool to resolve lost ids in the knowledge graph. use when you need to map a lost identifier to its canonical counterpart for data consistency.

Parámetros de entrada

typestring
The type of object (e.g., 'article', 'product'). If omitted, Diffbot will attempt to infer.
lostIdstringObligatorio
The lost ID which needs to be resolved to a canonical ID.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Start Bulk JobDIFFBOT_START_BULKAcción

Tool to start a bulk extract job. use when processing large numbers of urls asynchronously.

Parámetros de entrada

namestring
Optional job name for identification.
urlsstring[]
List of page URLs to process (max 1000).
apiUrlstringObligatoriouri
Full Extract API URL to call (must include token).
urlListstring
Comma-separated list of URLs or public file URL containing URLs.
jobConfigobject
Advanced bulk job configuration object.
notifyEmailstringemail
Email to notify when job completes.
notifyWebhookstringuri
Webhook URL to POST on job completion.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Start Crawl JobDIFFBOT_START_CRAWLAcción

Tool to spider a site for links and process them with the extract api into a single collection. use when you have seed urls and want to collect structured data across a site. requires a plus plan for crawl api access.

Parámetros de entrada

namestringObligatorio
Unique name for the crawl job.
typestringObligatorio
Type of content to extract (e.g., 'article', 'product').
seedsstring[]Obligatorio
List of URLs to begin crawling.
apiUrlstring
Custom Extract API endpoint to process crawled URLs.
repeatstring
Schedule for repeating this crawl (e.g., 'daily').
crawlDelaynumber
Seconds to wait between requests to the same domain.
maxToCrawlinteger
Maximum number of pages to crawl before stopping.
notifyEmailstring
Email to notify upon crawl completion.
maxToProcessinteger
Maximum number of pages to process through the Extract API.
customHeadersobject
Custom HTTP headers to include when crawling.
obeyRobotsTxtboolean
Whether to respect robots.txt directives.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Stop Bulk JobDIFFBOT_STOP_BULK_JOBAcción

Tool to stop a running bulk job. use when you need to halt further processing of urls in a job in progress. invoke only after confirming the jobid to avoid accidental stoppage.

Parámetros de entrada

jobIdstringObligatorio
Unique identifier of the Bulk job to stop

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not