Skip to main content

Find Links

Perform web searches to find links. Returns structured search results with titles, links, snippets, and optional pricing.

Parameters​

NameDescriptionAccepted ValuesDefaultRequired
I/O
queriesName or list of input columns containing search queries.string, array—Yes
idName of the column containing the row ID to append to each search result.string—Yes
outputOutput column for the dictionaries. If a list of 2 is provided, outputs [dicts_column, pretty_strings_column].string, array, nullnullNo
Options
n_resultsNumber of search results to return per query (default 10, max 100).integer10No
countryCountry code for search results (default 'us'). Alias: gl.string—No
languageLanguage code for search results (default 'en'). Alias: hl.string—No
locationLocation for search results (e.g., 'Austin, Texas').string—No
deviceDevice type for search results.string; one of:
  • desktop
  • mobile
  • tablet
—No
Conditions
ifCondition that determines whether the wrangle runs as a whole. Recipe variables may be referenced with ${variable}.string—No
whereFilter rows before applying the wrangle using SQL-like criteria, such as column1 = 123 OR column2 = 'abc'.string—No
where_paramsValues used with where for parameterized criteria. Uses SQLite placeholder syntax such as ? or :name.array, object—No
Execution
threadsNumber of concurrent threads for parallel processing (default 10).integer10No
Details
clientThe search provider to use.string; one of:
  • serpapi
"serpapi"No
api_keyAPI key for the search client. Can also be set as an environment variable (e.g., SERPAPI_API_KEY).string, nullnullNo

Examples​

This template searches once per query and returns structured result dictionaries. Search results vary by provider, location, and time.

wrangles:
- search.find_links:
id: Row ID
queries:
- Search Query
output:
- Search Results
api_key: Your SerpApi API key
client: serpapi
n_results: 5
Row IDSearch Query
1001SKF 6202 bearing supplier
Search Results
[{"title": "Example result", "link": "https://example.com/6202", "snippet": "SKF 6202 bearing"}]

Template based on the documented parameters; no published source example is currently available.

Access
RequirementValue
AI-poweredNo
Requires WrangleWorks accountNo
Requires subscriptionNo
Requires external API keyNo
Technical details
FieldValue
Catalog ID47
Catalog keysearch.find_links
Recipe keysearch.find_links
Catalog statusactive
Lifecycle statusactive
Recipe Writer eligibleYes
Namespacesearch
Documentation groupsearch
AliasesNone
Runtime symbolwrangles.recipe_wrangles.search.find_links
Legacy UUIDec1f661b-2cbc-4a47-88e3-646179104376

Sources