GET /serp

GET

serp

GET /serp?query=best+running+shoes

GET /serp?query=best+running+shoes&country=US&language=en&tag=rank.running-shoes&tag=footwear

{
  "query": "best running shoes",
  "pageNumber": 1,
  "dateDownloaded": "2026-10-10T09:30:00Z",
  "resultPages": 1,
  "totalOrganicResults": 1230000,
  "creditsUsed": 2,
  "organic": [
    {
      "position": 1,
      "title": "The Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our tested picks for every runner.",
      "domain": "example.com",
      "page": 1
    }
  ],
  "peopleAlsoAsk": [],
  "relatedSearches": []
}

{
  "detail": "Malformed query parameters."
}

{
  "detail": "Invalid SERP parameter (e.g. empty `query`, or invalid `country`/`language` code)."
}

{
  "detail": "Search rate limit reached."
}

{
  "detail": "The search returned an invalid or blocked response."
}

{
  "detail": "Search is unavailable."
}

{
  "detail": "Search request timed out."
}

Get parsed search results for a query: organic results and metadata, plus knowledge graph, People Also Ask, related searches, sitelinks, and result attributes when available. Some SERP features, and the estimated result total, aren’t always available. Search is billed at 2 credits per page of 10 results.

Authorization

Send your pline API key in the X-API-Key header on every request.

Query parameters

string

required

Keyword to search for.

string

default:"all"

Two-letter ISO country code to localize results, or all for all regions.

string

default:"en"

Two-letter result language code.

string[]

Labels attached to the request, for filtering and tracing in Request history. Repeat the parameter for multiple tags, for example ?tag=a&tag=b.

Response

string

required

integer

required

string

required

integer

required

Result pages the search covered. Billed per page.

integer

Estimated result total. Not always provided.

integer

required

object[]

required

Show organic properties

integer

required

1-based organic result position.

string

required

Result title.

string

required

Destination URL.

string

Result snippet, when available.

string

required

Result hostname.

integer

required

1-based SERP page containing this result.

object[]

Full-mode sitelinks associated with this result.

Show sitelinks properties

string

object

Full-mode normalized result attributes.

Show attributes properties

string

any

Additional structured domain metadata, when available.

any

Result classification metadata, when available.

object

Show knowledgeGraph properties

string

object[]

required

Show items properties

string

object[]

required

Show links properties

string

required

object[]

required

Show peopleAlsoAsk properties

string

Show relatedSearches properties

string

Response codes

Code	Meaning
`200`	Public SERP response
`400`	Malformed query parameters.
`422`	Invalid SERP parameter (e.g. empty `query`, or invalid `country`/`language` code).
`429`	Search rate limit reached.
`502`	The search returned an invalid or blocked response.
`503`	Search is unavailable.
`504`	Search request timed out.

GET /serp?query=best+running+shoes

GET /serp?query=best+running+shoes&country=US&language=en&tag=rank.running-shoes&tag=footwear

{
  "query": "best running shoes",
  "pageNumber": 1,
  "dateDownloaded": "2026-10-10T09:30:00Z",
  "resultPages": 1,
  "totalOrganicResults": 1230000,
  "creditsUsed": 2,
  "organic": [
    {
      "position": 1,
      "title": "The Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our tested picks for every runner.",
      "domain": "example.com",
      "page": 1
    }
  ],
  "peopleAlsoAsk": [],
  "relatedSearches": []
}

{
  "detail": "Malformed query parameters."
}

{
  "detail": "Invalid SERP parameter (e.g. empty `query`, or invalid `country`/`language` code)."
}

{
  "detail": "Search rate limit reached."
}

{
  "detail": "The search returned an invalid or blocked response."
}

{
  "detail": "Search is unavailable."
}

{
  "detail": "Search request timed out."
}

GET /serp?query=best+running+shoes

GET /serp?query=best+running+shoes&country=US&language=en&tag=rank.running-shoes&tag=footwear

{
  "query": "best running shoes",
  "pageNumber": 1,
  "dateDownloaded": "2026-10-10T09:30:00Z",
  "resultPages": 1,
  "totalOrganicResults": 1230000,
  "creditsUsed": 2,
  "organic": [
    {
      "position": 1,
      "title": "The Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our tested picks for every runner.",
      "domain": "example.com",
      "page": 1
    }
  ],
  "peopleAlsoAsk": [],
  "relatedSearches": []
}

{
  "detail": "Malformed query parameters."
}

{
  "detail": "Invalid SERP parameter (e.g. empty `query`, or invalid `country`/`language` code)."
}

{
  "detail": "Search rate limit reached."
}

{
  "detail": "The search returned an invalid or blocked response."
}

{
  "detail": "Search is unavailable."
}

{
  "detail": "Search request timed out."
}

Scrape

Batch scrape

Map

Crawl

SERP

Authorization

Query parameters

Response

Response codes

​Authorization

​Query parameters

​Response

​Response codes

Authorization

Query parameters

Response

Response codes