Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

The YouTube Search operation in this node allows users to perform searches on YouTube using custom queries. It is designed to retrieve video data based on search terms, making it useful for scenarios such as content discovery, market research, trend analysis, or gathering video metadata for further processing.

Practical examples include:

  • Searching for "funny cats videos" to collect popular or recent cat videos.
  • Gathering video IDs and titles related to a specific topic for content curation.
  • Automating the retrieval of YouTube search results for integration into dashboards or reports.

Properties

Name Meaning
Query The search query string to use on YouTube (e.g., "funny cats videos").
Async Whether to execute the request asynchronously (true/false).
Webhook URL to which Outscraper will send a POST request once the asynchronous task is finished.
Limit Maximum number of search results to return (minimum 1).
Additional Fields Collection of optional fields:
- Fields Comma-separated list of specific fields to include in the response (e.g., query,video_id,video_title).
- UI Whether to execute the request as a UI task (true/false).

Output

The output JSON contains the search results from YouTube according to the specified query and options. Each item typically includes video-related information such as video ID, title, and any additional requested fields.

If the operation is run asynchronously, the output may initially contain task status information, with final results delivered via the specified webhook URL.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for the Outscraper service.
  • The node depends on the Outscraper API endpoint configured via credentials.
  • For asynchronous execution, a publicly accessible webhook URL must be provided to receive callbacks.

Troubleshooting

  • Common issues:

    • Missing or invalid API key credential will cause authentication failures.
    • Providing an invalid webhook URL or no webhook URL when async mode is enabled can result in missed callbacks.
    • Exceeding the maximum allowed limit or providing invalid field names may cause errors or incomplete responses.
  • Error messages:

    • Authentication errors indicate problems with the API key; verify and update credentials.
    • Request validation errors often relate to missing required parameters like the query or invalid parameter formats.
    • Network or timeout errors suggest connectivity issues with the Outscraper API or webhook endpoint.

Links and References

Discussion