DataForSEO Integration with SmythOS
Need enterprise-grade, real-time search data? Connect DataForSEO to SmythOS and empower your agents to fetch live SERP data from Google, YouTube, and more, without managing proxies.
List of DataForSEO Components
Quickly compare DataForSEO components by what they do and their key I/O. Click any component name to jump directly to its detailed guide.
Component | Action | What it Does | Inputs | Key Outputs | Use Case |
---|---|---|---|---|---|
Live Google SERP Regular | Read | Fetches standard live Google web search results. | required keyword optional location_name | result , items_count | Basic keyword rank tracking. |
Live Google SERP Advanced | Read | Fetches detailed live Google web search results, including rich SERP features. | required keyword optional location_name | result , items_count | In-depth competitor SERP analysis. |
Live Google News Advanced | Read | Fetches live search results from Google News. | required keyword optional location_name | result , items_count | Monitor brand mentions and news trends. |
Live Google Images | Read | Fetches live search results from Google Images. | required keyword optional location_name | result , items_count | Track visual brand assets or product images. |
Live YouTube SERP Advanced | Read | Fetches live search results from YouTube. | required keyword optional location_name | result , items_count | Analyze video rankings and competitor strategies. |
Prerequisites
Before you begin, please ensure you have the following:
- An active SmythOS account. (Sign up here).
- A DataForSEO account.
- Your DataForSEO API
login
andpassword
(API key).
Getting Started With DataForSEO
Authentication for DataForSEO uses your API login and password, combined and encoded in Base64 format.
Step 1: Get Your DataForSEO API Credentials
- Log in to your DataForSEO Dashboard.
- Your API credentials (
login
andpassword
) are displayed on this page. Copy both of them.
Step 2: Encode Your Credentials in Base64
The API requires your credentials to be in the format login:password
and then Base64 encoded.
- Combine your credentials into a single string with a colon in between. For example:
my_email@example.com:your_password
. - Use an online tool or a local script to Base64 encode this string. The example
my_email@example.com:your_password
would become something likebXlfZW1haWxAZXhhbXBsZS5jb206eW91cl9wYXNzd29yZA==
. - Copy the resulting Base64 encoded string.
Step 3: Store Your Encoded Key in SmythOS Vault
Your encoded key is a sensitive credential. Use the SmythOS Vault
to store it securely.
- In your SmythOS dashboard, navigate to the Vault.
- Create a new secret and paste your Base64 encoded string as the value. Give it a memorable name, like
dataforseo_base64_key
. - For more details, see the Vault Documentation.
Step 4: Configure a DataForSEO Component
- In your SmythOS agent graph, drag and drop any DataForSEO component.
- Click the component to open its Settings panel.
- In the
Base64 Encoded Login and Password
field, select the secret you saved in the Vault (e.g.,dataforseo_base64_key
). - Your connection is now configured for that component.
Which DataForSEO Component Should I Use?
If you need to… | Target Platform | Use this Component | Why this one? |
---|---|---|---|
Check standard web rankings | Google Search | Live Google SERP Regular | Fast and efficient for basic organic position tracking. |
Analyze all SERP features (e.g., Knowledge Panel) | Google Search | Live Google SERP Advanced | Provides a richer, more detailed snapshot of the entire SERP. |
Monitor brand mentions in the news | Google News | Live Google News Advanced | Specifically targets news articles for PR and brand tracking. |
See what images rank for a query | Google Images | Live Google Images | Essential for visual branding and e-commerce product analysis. |
Research video competitor strategy | YouTube | Live YouTube SERP Advanced | Fetches video results to analyze titles, thumbnails, and rankings. |
Component Details
This section provides detailed information for each DataForSEO component.
Live Google SERP Regular
Fetches live, standard organic search results from Google for a given keyword.
Inputs
Field | Required | Notes |
---|---|---|
keyword | required | The keyword or phrase to search for. |
location_name | optional | Geographic location for the search (e.g., United Kingdom ). Default: United States . |
language_name | optional | Language for the search results (e.g., German ). Default: English . |
Outputs
Field | Description |
---|---|
result | An array of objects containing the SERP items, primarily organic results. |
items_count | The total number of items returned in the result array. |
response | The full raw JSON response from the DataForSEO API. |
headers | HTTP headers from the API response. |
{
"component": "dataforseo.liveGoogleSerpRegular",
"keyword": "no-code automation platform",
"location_name": "Canada"
}
Live Google SERP Advanced
Fetches a detailed snapshot of the live Google SERP, including rich features like knowledge panels, "people also ask", and more.
Inputs
Field | Required | Notes |
---|---|---|
keyword | required | The keyword or phrase to search for. |
location_name | optional | Geographic location for the search. Default: United States . |
language_name | optional | Language for the search results. Default: English . |
Outputs
Field | Description |
---|---|
result | An array of objects containing all SERP items, including organic, paid, and rich features. |
items_count | The total number of items returned in the result array. |
response | The full raw JSON response from the DataForSEO API. |
headers | HTTP headers from the API response. |
{
"component": "dataforseo.liveGoogleSerpAdvanced",
"keyword": "what is an llm agent",
"location_name": "United Kingdom"
}
Live Google News Advanced
Fetches live search results specifically from the Google News tab.
Inputs
Field | Required | Notes |
---|---|---|
keyword | required | The topic or brand name to search for in Google News. |
location_name | optional | Geographic location to target news sources. Default: United States . |
language_name | optional | Language of the news articles. Default: English . |
Outputs
Field | Description |
---|---|
result | An array of objects, each representing a news article found in the search results. |
items_count | The total number of news articles returned. |
response | The full raw JSON response from the DataForSEO API. |
headers | HTTP headers from the API response. |
{
"component": "dataforseo.liveGoogleNewsAdvanced",
"keyword": "SmythOS funding",
"location_name": "United States"
}
Live Google Images
Fetches live image search results from the Google Images tab.
Inputs
Field | Required | Notes |
---|---|---|
keyword | required | The search term for the images. |
location_name | optional | Geographic location for the search. Default: United States . |
language_name | optional | Language for the search results. Default: English . |
Outputs
Field | Description |
---|---|
result | An array of objects, each representing an image result with its URL, source, and title. |
items_count | The total number of images returned. |
response | The full raw JSON response from the DataForSEO API. |
headers | HTTP headers from the API response. |
{
"component": "dataforseo.liveGoogleImages",
"keyword": "SmythOS logo",
"location_name": "United States"
}
Live YouTube SERP Advanced
Fetches live search results from YouTube for a given keyword.
Inputs
Field | Required | Notes |
---|---|---|
keyword | required | The keyword or phrase to search for on YouTube. |
location_name | optional | Geographic location for tailoring search results. Default: United States . |
language_name | optional | Language for the search results. Default: English . |
Outputs
Field | Description |
---|---|
result | An array of objects, each representing a video result with its title, channel, and description. |
items_count | The total number of videos returned. |
response | The full raw JSON response from the DataForSEO API. |
headers | HTTP headers from the API response. |
{
"component": "dataforseo.liveYouTubeSerpAdvanced",
"keyword": "how to build an agent",
"location_name": "United States"
}
Best Practices & Advanced Tips
- Secure Your Credentials: Your DataForSEO login and password are the keys to your account. Always Base64 encode them and store the result securely in the SmythOS
Vault
. - Manage API Costs: DataForSEO operates on a pay-per-use model. Be mindful of how frequently your agents run and how many results they request to manage your budget.
- Use Location and Language: For accurate, targeted results, always specify the
location_name
andlanguage_name
. The defaults may not be suitable for your audience. - Parse the
result
Array: The data you need is inside theresult
array in the output. You will need to loop through this array and check thetype
of each item (e.g.,organic
,video
,news_result
) to process the data correctly.
Troubleshooting Common Issues
-
Error:
401 Unauthorized
- Cause: The Base64 encoded credential string is incorrect, or your DataForSEO account has an issue.
- Solution: Carefully re-encode your
login:password
string, ensuring there are no extra spaces. Verify your credentials are correct and your account is active in the DataForSEO dashboard.
-
Error:
402 Payment Required
/ Insufficient funds- Cause: Your DataForSEO account balance is too low to cover the cost of the API call.
- Solution: Log in to your DataForSEO account and add funds to your balance.
-
Empty
result
Array- Cause: The query genuinely returned no results for the specified parameters.
- Solution: Test the keyword, location, and language combination in your browser to confirm. Try a broader keyword or location to ensure the API connection is working.
What's Next?
You are now ready to harness real-time search data with the SmythOS DataForSEO Integration!
Consider these ideas:
-
Build an Agent That...
- Tracks a list of 20 keywords daily across 3 different countries, and logs the top-ranking URL for each into a centralized Google Sheet.
- Monitors Google News for your company's name. If a new article appears, use an AI component to summarize it and post the summary and link to a dedicated Slack channel.
- Analyzes the YouTube SERP for a "how-to" keyword, identifies the top 5 ranking videos, and extracts their titles and channels for competitive research.
-
Explore Other Integrations: Combine DataForSEO with other SmythOS connectors. Send SERP data to Google Sheets for analysis, use it to trigger Gmail alerts, or pass URLs you find to the Ahrefs Integration to check their backlink profiles.