Google Serper Videos
1 credits/call
ae_serper_videos
Search for videos on Google, including YouTube results with titles, channels, and durations.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | Search query. The request body field name must be q (not query). | — |
gl | string | No | Country code / geographic market, e.g. us. | — |
hl | string | No | Language code, e.g. en. | — |
num | integer | No | Number of results requested. | — |
tbs | string | No | Google time/search filter string, e.g. qdr:w. | — |
page | integer | No | Page number, when supported. | — |
location | string | No | Human-readable location bias, when supported. | — |
autocorrect | boolean | No | Whether query autocorrect should be enabled. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_serper_videos' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"num": 10,
"q": "AI construction robot BIM Revit November 10 2026"
}
}'Response exampleresponse.json
{
"credits": 1,
"searchParameters": {
"engine": "google",
"num": 10,
"page": 1,
"q": "AI construction robot BIM Revit November 10 2026",
"type": "videos"
},
"videos": [
{
"channel": "Project Flux",
"date": "1 week ago",
"duration": "2:05",
"imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTkiMHG47eABZa-RfxcHQb_aCq9obtZMwOYVFWzIetO9ep683KADtj46A&s",
"link": "https://www.youtube.com/watch?v=GBEPCq_Df6U",
"title": "The Machines Are on Site: AI and Robotics in Construction 2026"
}
]
}This example shows part of the response. Copied content is valid JSON.




