Volver al catálogo

Diffbot

diffbot

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

Acciones
14
Triggers
0
Autenticación
—
OAuth gestionado
No
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