IMPORTANT ASYNCHRONOUS TASK WORKFLOW
- Call this MCP generation tool once and read taskId from structuredContent.
- Do not call the generation tool again while the task is PENDING or RUNNING.
- Wait at least 5 seconds, then call nexscope_media_task_result with skillSlug set to seo-reverse-image-results, the exact taskId, and the same bearer API key. While the task remains PENDING or RUNNING, use 5, 10, 20, and 30-second progressive backoff. Never query more often than once every 5 seconds.
- Stop querying when the task succeeds or fails. On success, return the final Nexscope resource URLs and the returned count as the actual charged credits.
- Never invent a taskId and never expose internal provider names or provider resource URLs.
Search Results Rankings
Reverse Image Search Results MCP Tool
Reverse Image Search Results. Bounded Google reverse-image search observations with explicit missing evidence. One submit and at most eight fixed reads. Missing values are not zero. Prices and publication are unapproved. Owner-only historical results are retained seven days.
MCP tool name
nexscope_seo_reverse_image_resultsLegacy MCP endpoint
/api/skill-api/v1/mcpJSON-RPC method
tools/callAuthentication
Send the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Call this MCP tool
Use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "seo-reverse-image-results-1",
"method": "tools/call",
"params": {
"name": "nexscope_seo_reverse_image_results",
"arguments": {
"imageUrl": "https://example.com/"
}
}
}Legacy endpoint
POST /api/skill-api/v1/mcpCanonical detail URL
https://www.nexscope.ai/mcp-map/seo-reverse-image-resultsAsynchronous task workflow
This capability uses a create-and-query flow. Creating the task and retrieving its final generated resources are two connected requests.
- 1. Create onceCall the MCP tool once and keep the returned
taskId. - 2. Query with backoffCall
nexscope_media_task_resultwith this skill slug and task ID. Wait at least 5 seconds first; while pending or running, back off at 5, 10, 20, then 30-second intervals. - 3. Use final resultStop at a terminal status. Successful results contain Nexscope resource URLs and the actual charged-credit count.
MCP task result call
{
"jsonrpc": "2.0",
"id": "seo-reverse-image-results-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "seo-reverse-image-results",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}REST fallback
GET https://api.nexscope.ai/api/skill-api/v1/skills/seo-reverse-image-results/tasks/{taskId}Arguments
No arguments are defined for this tool.
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
One of option 1 — requires callId, status, result
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.result | any | required | Result value used by this API operation. |
data.callId | string | required | Call id value used by this API operation. |
data.schemaVersion | string | optional | Schema version value used by this API operation. |
data.status | string | required | Status value used by this API operation. |
data.source | string | optional | Source value used by this API operation. |
data.requestedAt | string | integer | null | optional | Requested at value used by this API operation. |
data.completedAt | string | integer | null | optional | Completed at value used by this API operation. |
data.coverage | object | null | optional | Coverage value used by this API operation. |
data.usage | object | null | optional | Usage value used by this API operation. |
data.usage.billingStatus | string | null | optional | Billing status value used by this API operation. |
data.usage.chargedCredits | string | integer | null | optional | Charged credits value used by this API operation. |
Any of option 1 — requires sourceProduct, sourceKind, marketScope, languageFilter, inputImageUrl, imageUrl, requestedLimit, returnedCount, truncated, associatedKeyword, sample, items, missing
| Name | Type | Required | Description |
|---|---|---|---|
data.result | object | required | Result value used by this API operation. |
data.result.sourceProduct | string | required | Source product value used by this API operation. Constant: serp |
data.result.sourceKind | string | required | Source kind value used by this API operation. Constant: google_reverse_image_sample |
data.result.marketScope | string | required | Market scope value used by this API operation. Constant: US |
data.result.languageFilter | string | required | Language filter value used by this API operation. Constant: en |
data.result.inputImageUrl | string | required | Input image url value used by this API operation. |
data.result.imageUrl | string | required | Image url value used by this API operation. |
data.result.requestedLimit | integer | required | Requested limit value used by this API operation. Minimum: 1 Maximum: 20 |
data.result.returnedCount | integer | required | Returned count value used by this API operation. Minimum: 0 Maximum: 20 |
data.result.truncated | boolean | required | Truncated value used by this API operation. |
data.result.associatedKeyword | string | null | required | Associated keyword value used by this API operation. |
data.result.sample | any | required | Sample value used by this API operation. |
data.result.items | array | required | Items value used by this API operation. Maximum items: 20 |
data.result.items[] | any | required | Item in data result items. |
data.result.missing | array | required | Missing value used by this API operation. |
data.result.missing[] | object | required | Item in data result missing. |
data.result.missing[].field | string | required | Field value used by this API operation. |
data.result.missing[].reason | string | required | Reason value used by this API operation. Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.result.sample | null | required | Sample value used by this API operation. |
Any of option 2 — requires observedAt, checkUrl, observedTypes
| Name | Type | Required | Description |
|---|---|---|---|
data.result.sample | object | required | Sample value used by this API operation. |
data.result.sample.observedAt | integer | null | required | Observed at value used by this API operation. Minimum: 0 |
data.result.sample.checkUrl | string | null | required | Check url value used by this API operation. |
data.result.sample.observedTypes | array | required | Observed types value used by this API operation. |
data.result.sample.observedTypes[] | string | required | Item in data result sample observedTypes. |
One of option 1 — requires kind, url, title, rankGroup, rankAbsolute, missing
| Name | Type | Required | Description |
|---|---|---|---|
data.result.items[] | object | required | Item in data result items. |
data.result.items[].kind | string | required | Kind value used by this API operation. Constant: PAGE |
data.result.items[].url | string | required | Url value used by this API operation. |
data.result.items[].title | string | null | required | Title value used by this API operation. |
data.result.items[].rankGroup | integer | null | required | Rank group value used by this API operation. Minimum: 1 |
data.result.items[].rankAbsolute | integer | null | required | Rank absolute value used by this API operation. Minimum: 1 |
data.result.items[].missing | array | required | Missing value used by this API operation. |
data.result.items[].missing[] | object | required | Item in data result items[] missing. |
data.result.items[].missing[].field | string | required | Field value used by this API operation. |
data.result.items[].missing[].reason | string | required | Reason value used by this API operation. Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
One of option 2 — requires kind, pageUrl, imageUrl, alt, parentRankGroup, parentRankAbsolute, missing
| Name | Type | Required | Description |
|---|---|---|---|
data.result.items[] | object | required | Item in data result items. |
data.result.items[].kind | string | required | Kind value used by this API operation. Constant: IMAGE |
data.result.items[].pageUrl | string | required | Page url value used by this API operation. |
data.result.items[].imageUrl | string | null | required | Image url value used by this API operation. |
data.result.items[].alt | string | null | required | Alt value used by this API operation. |
data.result.items[].parentRankGroup | integer | null | required | Parent rank group value used by this API operation. Minimum: 1 |
data.result.items[].parentRankAbsolute | integer | null | required | Parent rank absolute value used by this API operation. Minimum: 1 |
data.result.items[].missing | array | required | Missing value used by this API operation. |
data.result.items[].missing[] | object | required | Item in data result items[] missing. |
data.result.items[].missing[].field | string | required | Field value used by this API operation. |
data.result.items[].missing[].reason | string | required | Reason value used by this API operation. Allowed: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.result | null | required | Result value used by this API operation. |
One of option 2 — requires callId, status, reason, retryable
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.reason | string | required | Reason value used by this API operation. |
data.callId | string | null | required | Call id value used by this API operation. |
data.status | string | required | Status value used by this API operation. |
data.retryable | boolean | required | Retryable value used by this API operation. |
data.taskId | string | null | optional | Task id value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Examples
Example arguments
{
"imageUrl": "https://example.com/"
}Example structuredContent
{
"data": {
"status": "PROCESSING",
"retryable": false,
"reason": "IN_PROGRESS",
"callId": "00000000-0000-4000-8000-000000000001"
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}