Felo API PlatformFelo API Platform

Data API / DataForSEO / SERP

Setting Google Search By Image SERP Tasks

Queues the pages Google finds for an image URL on Google, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

Parameters

No path, query, or header parameters.

Request body

  • image_urlstringRequired

    Publicly accessible image URL used as the search input

  • location_codeintegerOptional

    Search engine location code

  • location_namestringOptional

    Full name of search engine location

  • location_coordinatestringOptional

    GPS coordinates of a location

  • language_codestringOptional

    Search engine language code

  • language_namestringOptional

    Full name of search engine language

  • priorityintegerOptional

    Task priority

  • postback_urlstringOptional

    URL for sending task results

  • pingback_urlstringOptional

    Notification URL of a completed task

  • postback_datastringOptional

    Postback datatype; possible values include advanced and html

Example request

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/search_by_image/task_post" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image_url": "<string>",
  "location_code": 0,
  "location_name": "<string>",
  "location_coordinate": "<string>",
  "language_code": "<string>",
  "language_name": "<string>",
  "priority": 0,
  "postback_url": "<string>"
}'

Response

Response fields

  • versionstringOptional

    The current version of the API

  • status_codeintegerOptional

    General status code

  • status_messagestringOptional

    General informational message

  • timestringOptional

    Execution time, seconds

  • costnumberOptional

    Total tasks cost, USD

  • tasks_countintegerOptional

    The number of tasks in the tasks array

  • tasks_errorintegerOptional

    The number of tasks in the tasks array returned with an error

  • tasksstring[]Optional

    Array of task objects

  • idstringOptional

    Task identifier in UUID format

  • status_codeintegerOptional

    Task status code

  • status_messagestringOptional

    Task status message

  • costnumberOptional

    Cost of the task, USD

  • result_countintegerOptional

    Number of elements in the result array