generated: '2026-10-18'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.gtm-api.com/concepts/pagination-and-filtering.md
sources:
- https://docs.gtm-api.com/concepts/pagination-and-filtering.md
- https://docs.gtm-api.com/quickstart.md
- https://docs.gtm-api.com/authentication.md
idempotency:
  coverage: partial
  evidence: idempotency_key on 46 of 249 mutating operations
  scope:
  - enrich_linkedin_company_lite_profile
  - enrich_linkedin_company_posts
  - enrich_linkedin_company_profile
  - enrich_linkedin_company_public_identifier
  - enrich_linkedin_get_activity_urn_by_url
  - enrich_linkedin_person_basic_profile
  - enrich_linkedin_person_certifications
  - enrich_linkedin_person_comment_activity
  - enrich_linkedin_person_contact_info
  - enrich_linkedin_person_education
  - enrich_linkedin_person_experience
  - enrich_linkedin_person_featured
  - enrich_linkedin_person_full_profile
  - enrich_linkedin_person_interests
  - enrich_linkedin_person_languages
  - enrich_linkedin_person_lite_profile
  - enrich_linkedin_person_posts
  - enrich_linkedin_person_reaction_activity
  - enrich_linkedin_person_recommendations
  - enrich_linkedin_person_services
  - enrich_linkedin_person_skills
  - enrich_linkedin_post_details
  - scrape_linkedin_build_search_url
  - scrape_linkedin_company_decision_makers
  - scrape_linkedin_company_employees
  - scrape_linkedin_get_post_comments
  - scrape_linkedin_get_post_reactors
  - scrape_linkedin_get_post_resharers
  - scrape_linkedin_param_id_lookup
  - scrape_linkedin_recruiter_param_id_lookup
  - scrape_linkedin_sales_nav_param_id_lookup
  - scrape_linkedin_search_companies
  - scrape_linkedin_search_courses
  - scrape_linkedin_search_events
  - scrape_linkedin_search_groups
  - scrape_linkedin_search_jobs
  - scrape_linkedin_search_people
  - scrape_linkedin_search_posts
  - scrape_linkedin_search_products
  - scrape_linkedin_search_recruiter_people
  - scrape_linkedin_search_sales_nav_companies
  - scrape_linkedin_search_sales_nav_people
  - scrape_linkedin_search_schools
  - scrape_linkedin_search_service_providers
  - scrape_linkedin_similar_companies
  - scrape_linkedin_similar_profiles
  header: idempotency_key
  mechanism: request header / body token declared in the OpenAPI
  verified: derived
pagination:
  style: cursor‑based
  params:
  - page_size
  - cursor
  - filter
  - sort
  - include
  response_fields:
  - pagination.next_cursor
  - pagination.has_more
  - pagination.total_count
  evidence: List endpoints use `page_size` (default 50, max 100‑1000 per endpoint) and an opaque `cursor`. `pagination.next_cursor` is returned;
    `null` means last page. `include` loads related objects.
error_envelope: Responses use a standard envelope with top‑level `success` (boolean), `operation` (string), and a `meta` object containing `trace_id`.
  Errors follow the same envelope shape with an `error` block and one of the 16 documented error codes.
authentication: 'All requests require an `Authorization: Bearer <token>` header. Tokens are either API keys (`gtm_live_` + 40 chars) or short‑lived
  session JWTs. An optional `Team-SID` header can select a team when the token lacks team scope.'
request_tracing: Each successful response includes `meta.trace_id` for support tracing.
field_expansion: The `include` query parameter (array) names relations to load; included data appear under `items[].included` and the top‑level
  `includes` echoes the request.
docs: https://docs.gtm-api.com/concepts/pagination-and-filtering.md