Expanded Limits, Across all tiers - Our Gift to you! Learn more →

AlterLab
SearchResearchPricingComparePlaygroundBlogDocsChangelog
    AlterLabAlterLab
    PricingComparePlaygroundBlogDocsChangelog
    IntroductionQuickstartInstallationYour First Request
    REST APICrawl APIMap APISearch APIResearch APINewSERP APINewExtract APIAIJob PollingDomain StatsNewGeocode APINewNews APIBatch ResultsNewAPI KeysSessions APINewEnterprise APIEnterprise
    AccountAutoAI VisibilityAutoAlertsAutoAuthAutoBillingAutoCrawlAutoExtractAutoIntegrationsAutoKeysAutoMapAutoMonitorsAutoOrganizationsAutoResearch SchedulesAutoRunsAutoSchedulesAutoScrapeAutoSearchAutoSearch SchedulesAutoSessionsAutoUser WebhooksAutoV1 EndpointsAutoAffiliatesAutoAgentAutoAgent OnboardingAutoAgent VisibilityAutoAnalyticsAutoApprovalsAutoArtifactsAutoAttributionAutoB2BAutoBatchAutoBeta FeaturesAutoBlogAutoBuyerAutoChatAutoConnectionsAutoConnectorsAutoContact ListsAutoCreatorAutoCross SellAutoDashboardAutoDefaultsAutoDomainsAutoEmail PreferencesAutoFcAutoHandsAutoHealthAutoJobsAutoListingsAutoMaintenanceAutoNewsAutoOauthAutoOauth GrantsAutoPage InspectAutoPlatformAutoPresetsAutoPricingAutoPrivacyAutoPublicAutoPublic PagesAutoReferralAutoReferralsAutoReportsAutoResearchAutoSecretsAutoSerpAutoSSOAutoStorefrontsAutoSupportAutoTemplatesAutoToolsAutoTrackAutoUsageAutoUsage TagsAutoUserAutoWorkflowsAutoWorkspacesAutoWebhooksAuto
    OverviewPythonNode.jsCLI
    Guides OverviewJavaScript RenderingBrowser ActionsOutput FormatsPDF & OCRCachingWebhooksJSON Schema FilteringWebSocket Real-TimeBring Your Own ProxyProSticky SessionsProAuthenticated ScrapingNewHTTP Methods & BodiesNewStructured ExtractionAIWeb SearchAgent and RAG GroundingResearch JobsAgent RunsSite MappingWeb CrawlingBatch ScrapingSchedulerData MarketplaceSelling DataAgent OnboardingEmbeddingsKeyword IdeasAI VisibilityWorkflowsChange DetectionCloud Storage ExportSpend LimitsOrganizations & TeamsScrape TemplatesCustom ConnectorsSecretsContact ListsPlatform Sub-AccountsReferrals & AffiliatesAlerts & NotificationsExtraction ProfilesAIBYOK ExtractionAIOAuth2 Machine-to-MachineSupport & TicketsUnsupported Targets
    Tutorials OverviewStructured ExtractionAIE-commerce ScrapingNews MonitoringPrice MonitoringMulti-Page CrawlingMonitoring DashboardAI Agent / MCPMCPAI Research AgentAISite CrawlingData Pipeline to Cloud
    E-commerceLead GenerationChange MonitoringRAG & AI PipelinesAIResearch
    Reference OverviewPricingRate LimitsReliabilityReliability ContractError CodesChangelogVersioning
    Migrations OverviewFrom FirecrawlFrom ApifyFrom ScrapingBee / ScraperAPIFrom Crawl4AIFrom SpiderSearch to SERPFirecrawl v0 API ReferenceLegacy
    OverviewMCP ServerAIn8n NodeLangChainAICrewAIAILlamaIndexAISupabaseChrome ExtensionSoon
    PlaygroundPricingStatus

    Up to 5,000 free requests · No credit card

    Guide

    Referrals & Affiliates

    Programmatic access to the referral program and the affiliate program. Both are also available in the dashboard.

    Not an agent workflow

    These programs are for people. There is no MCP tool for them; the endpoints exist for dashboards and partner integrations.

    Referral Link and Stats

    GET /api/v1/referral/my-link returns your link and GET /api/v1/referral/stats your stats. GET /api/v1/referrals/code returns or creates your code, GET /api/v1/referrals/stats the dashboard stats and GET /api/v1/referrals/events the event history (page, page_size).

    Bash
    curl https://api.alterlab.io/api/v1/referral/my-link   -H "X-API-Key: $ALTERLAB_API_KEY"

    Validate a Code

    POST /api/v1/referral/validate-code checks a code before sign-up.

    Bash
    curl -X POST https://api.alterlab.io/api/v1/referral/validate-code   -H "X-API-Key: $ALTERLAB_API_KEY" -H "Content-Type: application/json"   -d '{"code": "FRIEND10"}'

    Affiliate Program

    POST /api/v1/affiliates/apply takes optional notes. GET /api/v1/affiliates/me returns your profile, /me/stats your stats and /me/conversions your conversions (status, page, page_size).

    Bash
    curl -X POST https://api.alterlab.io/api/v1/affiliates/apply   -H "X-API-Key: $ALTERLAB_API_KEY" -H "Content-Type: application/json"   -d '{"notes": "Newsletter about data tooling"}'

    Track a Click

    POST /api/v1/affiliates/track/click records a click for a referral_code, with an optional landing_page.

    Bash
    curl -X POST https://api.alterlab.io/api/v1/affiliates/track/click   -H "Content-Type: application/json"   -d '{"referral_code": "FRIEND10", "landing_page": "/pricing"}'
    Platform Sub-AccountsAlerts & Notifications
    Last updated: June 2026

    On this page