> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Backlinks

> Get the backlinks pointing to a domain or page.

# Backlinks

List the individual links pointing to a site or page, strongest first. Each backlink gives the linking page and its title, the page linked to, anchor text, link type, dofollow status and rel attributes, authority scores for the link, page and domain, spam score, where the link sits on the page, and when it was first and last seen. Use it to audit your own link profile, reverse-engineer a competitor's best links, or find pages worth asking for a link.

```json theme={"dark"}
{
  "target": "notion.so",
  "results_limit": 100
}
```

Provide a domain, subdomain or page URL in target. results\_limit defaults to 100 and accepts integers from 1 to 1000. Each request costs a 10-credit base for the lookup plus 0.02 credits per backlink returned.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Identifier of the link, derived from the linking page, the linked page and the anchor. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | URL of the page that contains the link. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `source_url` | `string` | Yes | URL of the page that contains the link. |
| `source_domain` | `string` | Yes | Domain of the page that contains the link. |
| `source_title` | `string` | Yes | Title of the page that contains the link. |
| `target_url` | `string` | Yes | URL the link points to. |
| `anchor` | `string` | Yes | Anchor text of the link. |
| `link_type` | `string` | Yes | Kind of link, such as `anchor`, `image`, `redirect` or `canonical`. |
| `is_dofollow` | `boolean` | Yes | Whether the link is a dofollow link that passes ranking value. |
| `attributes` | `array<string>` | Yes | rel attributes on the link, such as `nofollow` or `ugc`. |
| `rank` | `integer` | Yes | Authority score of the link from 0 to 1000. |
| `source_page_rank` | `integer` | Yes | Authority score of the linking page from 0 to 1000. |
| `source_domain_rank` | `integer` | Yes | Authority score of the linking domain from 0 to 1000. |
| `spam_score` | `integer` | Yes | Spam score from 0 to 100; higher means more signs of spam. |
| `semantic_location` | `string` | Yes | Part of the page where the link sits, such as `article`, `nav` or `footer`. |
| `language` | `string` | Yes | Language code of the linking page. |
| `is_new` | `boolean` | Yes | Whether the link was found since the previous crawl. |
| `is_lost` | `boolean` | Yes | Whether the link has disappeared from the linking page. |
| `is_broken` | `boolean` | Yes | Whether the linked page no longer loads. |
| `first_seen_at` | `string` | Yes | Time the link was first found, in ISO 8601 format. |
| `last_seen_at` | `string` | Yes | Time the link was last confirmed, in ISO 8601 format. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-seo-backlinks",
    "status": "succeeded",
    "public_id": "seo/backlinks",
    "result_count": 1,
    "credits_amount": 10.02,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "backlink",
      "schema_version": "1.0",
      "items": [
        {
          "id": "36af82e3018f12d6387d",
          "platform": "seo",
          "resource": "backlinks",
          "type": "backlink",
          "url": "https://corporate.sarah30.com/",
          "published_at": null,
          "collected_at": "2026-11-17T14:43:18.061725Z",
          "source_url": "https://corporate.sarah30.com/",
          "source_domain": "corporate.sarah30.com",
          "source_title": "SARAH inc.",
          "target_url": "https://www.notion.so/SARAH-97caa9e30b1941cfbacc35558d1af86a",
          "anchor": "採用情報",
          "link_type": "anchor",
          "is_dofollow": true,
          "attributes": [
            "noopener",
            "noreferrer"
          ],
          "rank": 649,
          "source_page_rank": 684,
          "source_domain_rank": 518,
          "spam_score": 40,
          "semantic_location": "nav",
          "language": null,
          "is_new": false,
          "is_lost": false,
          "is_broken": false,
          "first_seen_at": "2021-03-08T21:58:57Z",
          "last_seen_at": "2026-10-24T12:45:53Z"
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/seo/backlinks
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/seo/backlinks:
    post:
      tags:
        - seo
      summary: Backlinks API
      description: Collect the backlinks pointing to a domain or page.
      operationId: socq_seo_backlinks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                results_limit:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 100
                target:
                  type: string
                  minLength: 1
                  description: >-
                    Domain, subdomain or page URL, such as example.com or
                    https://example.com/blog/.
              required:
                - target
              description: >-
                Provide a domain, subdomain or page URL in target. results_limit
                defaults to 100 and accepts integers from 1 to 1000. Strongest
                links come first.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.