Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Add keyword-based tasks to scrape Google Search results. Each task represents a search query that will be executed on Google.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Request body format. Value: application/json

​
Request Body

FieldTypeRequiredDescription
squidstringYesHash of your squid configured with the google-search-scraper crawler
tasksarrayYesArray of task objects, each containing a keyword field

​
Task Object

FieldTypeRequiredDescription
keywordstringYesThe search query to execute on Google
You can add multiple keywords in a single request for bulk searches.
Configure search parameters like country, language, and max_pages in the squid settings.

​
Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": [
      {"keyword": "crab"},
      {"keyword": "lobster recipes"}
    ],
    "squid": "YOUR_SQUID_HASH"
  }'

​
Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "36a5f24a550f89c2b997107ca043ec8a",
      "created_at": "2025-06-30T08:25:29.311114",
      "is_active": true,
      "params": {
        "keyword": "crab"
      },
      "module": 128,
      "object": "task"
    }
  ]
}