Linkup | Apiosk Gateway

Method	Path	Description	Cost
POST	/v1/fetch	Turn one URL into clean markdown an agent can read: Linkup fetches the page, optionally renders its JavaScript, and strips the navigation and boilerplate. Can also pull structured fields out of the page against a schema you provide.	$0.01 default	View details
POST	/v1/search	Ask a question of the live web and choose the shape of the answer: a ranked list of sources with their text, a written answer with the sources it cites, or JSON matching a schema you supply. Scope it to a date range or a domain list.	$0.01 default	View details

POST/v1/fetch

$0.01 default

Description

Turn one URL into clean markdown an agent can read: Linkup fetches the page, optionally renders its JavaScript, and strips the navigation and boilerplate. Can also pull structured fields out of the page against a schema you provide.

Pricing

$0.01 default

Request schema

{
  "properties": {
    "extractImages": {
      "default": false,
      "description": "Also return the images found on the page.",
      "type": "boolean"
    },
    "includeRawContent": {
      "default": false,
      "description": "Also return the raw page content and its content type.",
      "type": "boolean"
    },
    "instructions": {
      "description": "Optional guidance for the extraction. Requires schema.",
      "example": "Use public list prices only and express monetary values in USD.",
      "type": "string"
    },
    "mode": {
      "default": "standard",
      "description": "pro has a markedly higher success rate on pages that resist scraping. Same price.",
      "enum": [
        "standard",
        "pro"
      ],
      "type": "string"
    },
    "renderJs": {
      "default": false,
      "description": "Render the page's JavaScript before reading it.",
      "type": "boolean"
    },
    "schema": {
      "description": "Optional JSON schema (root type object) describing structured data to extract from the page. Fields with no grounded value are left out.",
      "example": "{\"type\":\"object\",\"properties\":{\"price\":{\"type\":\"number\"}}}",
      "type": "string"
    },
    "url": {
      "description": "The page to fetch.",
      "example": "https://docs.linkup.so",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

Response schema

{
  "properties": {
    "contentType": {
      "description": "Present when rawContent is returned.",
      "type": "string"
    },
    "data": {
      "description": "Present when schema is provided.",
      "type": "object"
    },
    "favicon": {
      "format": "uri",
      "type": "string"
    },
    "images": {
      "items": {
        "properties": {
          "alt": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "markdown": {
      "description": "The clean markdown version of the page.",
      "type": "string"
    },
    "rawContent": {
      "description": "Present when includeRawContent is true.",
      "type": "string"
    }
  },
  "required": [
    "markdown",
    "favicon"
  ],
  "type": "object"
}

Example request

{
  "mode": "standard",
  "renderJs": false,
  "url": "https://docs.linkup.so"
}

Example response

{
  "favicon": "https://favicons.linkup.so?domain=docs.linkup.so",
  "markdown": "Get started for free, no credit card required..."
}

POST/v1/search

$0.01 default

Description

Ask a question of the live web and choose the shape of the answer: a ranked list of sources with their text, a written answer with the sources it cites, or JSON matching a schema you supply. Scope it to a date range or a domain list.

Pricing

$0.01 default

Request schema

{
  "properties": {
    "depth": {
      "default": "standard",
      "description": "fast is a sub-second mode for simple, focused queries; standard uses agentic search for broader questions. Linkup also has deep, but it charges five times as much for it as this listing sells, so it is not offered here.",
      "enum": [
        "fast",
        "standard"
      ],
      "type": "string"
    },
    "excludeDomains": {
      "description": "Drop results from these domains.",
      "example": [
        "wikipedia.org"
      ],
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fromDate": {
      "description": "Only consider results published on or after this date (YYYY-MM-DD).",
      "example": "2025-01-01",
      "format": "date",
      "type": "string"
    },
    "includeDomains": {
      "description": "Search only these domains.",
      "example": [
        "microsoft.com"
      ],
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "type": "array"
    },
    "includeImages": {
      "default": false,
      "description": "Include image results.",
      "type": "boolean"
    },
    "includeInlineCitations": {
      "default": false,
      "description": "Only for sourcedAnswer: put the citations inline in the answer.",
      "type": "boolean"
    },
    "includeSources": {
      "default": false,
      "description": "Only for structured: add the sources to the response. It changes the response shape.",
      "type": "boolean"
    },
    "maxResults": {
      "description": "Upper bound on the number of results.",
      "example": 5,
      "minimum": 1,
      "type": "number"
    },
    "outputType": {
      "description": "searchResults returns the sources and their text; sourcedAnswer returns a written answer plus its sources; structured returns JSON matching structuredOutputSchema.",
      "enum": [
        "searchResults",
        "sourcedAnswer",
        "structured"
      ],
      "type": "string"
    },
    "q": {
      "description": "The natural language question you want context for.",
      "example": "What is Microsoft's 2024 revenue?",
      "type": "string"
    },
    "structuredOutputSchema": {
      "description": "Required when outputType is structured: a JSON schema, as a string, whose root is an object.",
      "example": "{\"type\":\"object\",\"properties\":{\"revenue\":{\"type\":\"number\"}}}",
      "type": "string"
    },
    "toDate": {
      "description": "Only consider results published on or before this date (YYYY-MM-DD).",
      "example": "2025-12-31",
      "format": "date",
      "type": "string"
    }
  },
  "required": [
    "q",
    "depth",
    "outputType"
  ],
  "type": "object"
}

Response schema

{
  "description": "Shape depends on outputType.",
  "properties": {
    "answer": {
      "description": "outputType sourcedAnswer.",
      "type": "string"
    },
    "results": {
      "description": "outputType searchResults.",
      "items": {
        "properties": {
          "content": {
            "type": "string"
          },
          "favicon": {
            "format": "uri",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "enum": [
              "text",
              "image"
            ],
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "sources": {
      "items": {
        "properties": {
          "favicon": {
            "format": "uri",
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "snippet": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Example request

{
  "depth": "standard",
  "includeDomains": [
    "microsoft.com"
  ],
  "outputType": "sourcedAnswer",
  "q": "What is Microsoft's 2024 revenue?"
}

Example response

{
  "answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
  "sources": [
    {
      "name": "Microsoft 2024 Annual Report",
      "snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
      "url": "https://www.microsoft.com/investor/reports/ar24/index.html"
    }
  ]
}