Postclick by PPC.io: Landing Page CRO

{'type': 'object', 'required': ['audit_id', 'topic'], 'properties': {'topic': {'enum': ['buyers', 'the_pitch', 'trust', 'competitors', 'copy', 'leaks', 'the_page', 'technical'], 'type': 'string', 'description': 'Which part of the audit answers the question. buyers · the_pitch · trust · competitors · copy · leaks · the_page · technical.'}, 'audit_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The live landing page URL to audit.'}, 'context': {'type': 'string', 'description': "Optional, up to 500 characters. What the page is for, in the user's own words: the offer, who it is aimed at, the campaign sending traffic to it. Pass what they have ALREADY told you rather than interrogating them for it. The audit reads the page but cannot know the intent behind it, so this sharpens who it judges the page against. Leave it out if they have not said."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id', 'concept_id'], 'properties': {'audit_id': {'type': 'string'}, 'direction': {'type': 'string', 'description': 'Optional plain-English steer for the build.'}, 'concept_id': {'type': 'string', 'description': 'From get_concepts.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['build_run_id'], 'properties': {'platform': {'enum': ['wordpress', 'webflow', 'framer', 'wix', 'squarespace', 'shopify', 'other'], 'type': 'string', 'description': "Where the user's site lives. Omit if unknown and the instructions will assume nothing."}, 'build_run_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'id': {'type': 'string', 'description': 'Source ID returned by search. Alias of uri for ChatGPT retrieval.'}, 'uri': {'type': 'string', 'description': 'The address, like postclick://audit/<id>. A bare id works too and will be looked up.'}, 'expand': {'type': 'string', 'description': 'Comma separated names of things to pull in with it, or `*` for all of them. Every answer lists what else is available under available_links, so you can always go deeper without guessing.'}, 'fields': {'type': 'string', 'description': 'Comma separated field names, when you only need a few. Left out, you get the useful ones.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id'], 'properties': {'count': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'How many distinct directions the user wants, up to 12. Leave it out for the standard pack of 2. Higher costs more, so quote the total back before agreeing to it. Directions that already exist are counted and reused, never bought twice.'}, 'audit_id': {'type': 'string'}, 'direction': {'type': 'string', 'description': 'Optional plain-English creative steer. Honoured above other design choices.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['asset_id'], 'properties': {'as': {'enum': ['url', 'bytes'], 'type': 'string', 'description': '`url` for a link, which is right for anything you publish and is the default. `bytes` only for a document that cannot load a picture from another website.'}, 'asset_id': {'type': 'string', 'description': 'The id from a picture field, like concept:<id>:image.'}, 'max_width': {'type': 'integer', 'maximum': 2048, 'minimum': 64, 'description': 'How wide the picture comes back when you ask for bytes. 1024 by default, which is readable in a report. Smaller is cheaper.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id'], 'properties': {'wait': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'Seconds to wait for a material change. Use 25 for broad client compatibility; longer waits are available for hosts that support them. A timeout preserves the run; resume by ID instead of starting again.'}, 'audit_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id'], 'properties': {'topic': {'type': 'string', 'description': 'Optional. Return only this part of the report instead of all of it. The same keys ask_audit takes: buyers, the_pitch, trust, competitors, copy, leaks, the_page, technical.'}, 'audit_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['build_run_id'], 'properties': {'wait': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'Seconds to wait for a material change. Use 25 for broad client compatibility; longer waits are available for hosts that support them. A timeout preserves the run; resume by ID instead of starting again.'}, 'build_run_id': {'type': 'string'}, 'include_html': {'type': 'boolean', 'description': 'Return the full page HTML. Large. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id'], 'properties': {'audit_id': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['audit_id'], 'properties': {'wait': {'type': 'integer', 'maximum': 300, 'minimum': 0, 'description': 'Seconds to wait for a material change. Use 25 for broad client compatibility; longer waits are available for hosts that support them. A timeout preserves the run; resume by ID instead of starting again.'}, 'audit_id': {'type': 'string'}, 'concept_id': {'type': 'string', 'description': 'Optional. Given one, returns that design as its full stack of bands in page order instead of one opening screen per design.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'subject_uri': {'type': 'string', 'description': "Limit to one record's notes. Leave it out for all of them."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['html'], 'properties': {'html': {'type': 'string', 'description': 'The whole page with inline CSS. Use image URLs from get_asset; avoid embedding large image data.'}, 'slug': {'type': 'string', 'description': 'The last part of the address, like acme-october-review. Taken from the title when left out. Pass the same one again to update a report you already sent.'}, 'title': {'type': 'string', 'description': 'What the report is called.'}, 'subject_uri': {'type': 'string', 'description': 'The address of the audit or project it was built from, if there is one.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['skill'], 'properties': {'page': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Page URL, domain or client name. Leave out when audit_id is known or the user explicitly requested latest.'}, 'skill': {'enum': ['postclick-fix-first', 'postclick-message-match', 'postclick-buyer-objections', 'postclick-copy-rewrite', 'postclick-experiment-brief'], 'type': 'string', 'description': 'Choose postclick-fix-first for the first fix; postclick-copy-rewrite for replacement words; postclick-experiment-brief for a designer note or handoff; postclick-message-match for comparing an ad; postclick-buyer-objections for buyer hesitation.'}, 'latest': {'type': 'boolean', 'description': 'Use true only when the user explicitly asks for their latest or most recent audit. May be combined with page to find its latest audit.'}, 'context': {'type': 'string', 'maxLength': 3000, 'description': "The user's ad copy, audience, constraints or desired output. Pass known context; do not require an interview."}, 'section': {'enum': ['opening', 'page'], 'type': 'string', 'description': 'For copy rewrites, defaults to opening (headline, supporting line and button). Use page when the user asks for other sections or the whole page.'}, 'audit_id': {'type': 'string', 'pattern': '^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$', 'description': 'An audit ID returned by Postclick or extracted from the user’s /dashboard/a/<audit_id> link. For that link use audit_id, not page or latest. Never ask the user to find an ID.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['subject_uri', 'key'], 'properties': {'key': {'type': 'string', 'description': 'Your own name for this field.'}, 'value': {'type': ['string', 'number', 'boolean', 'object', 'array', 'null'], 'description': 'Anything: a string, a number, a list, an object.'}, 'subject_uri': {'type': 'string', 'description': 'The address of the thing this is about, like postclick://audit/<id>.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'kind': {'type': 'string', 'description': 'Narrow to a kind such as audit, concept, build or project. Leave it out to search everything at once, which is usually what you want.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How many to return. 20 by default.'}, 'query': {'type': 'string', 'description': 'Words to match: a domain, part of a URL, a client name, a caption. Leave it out to list the most recent work instead of searching.'}, 'since': {'type': 'string', 'description': 'Only things newer than this date, as YYYY-MM-DD.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'section': {'enum': ['full', 'competitors'], 'type': 'string', 'description': 'Which part of the audit the link opens. Only with audit_id. `competitors` opens on who is bidding against the page, for forwarding that one answer. Defaults to full.'}, 'audit_id': {'type': 'string', 'description': 'Share an AUDIT. From audit_page or get_audit. Use this when someone wants to forward the findings themselves rather than a design or a built page.'}, 'concept_id': {'type': 'string', 'description': 'Share a design. From get_concepts. This is the one to use when someone wants to show designs to a client.'}, 'build_run_id': {'type': 'string', 'description': 'Share a finished built page. From build_page or get_build.'}}, 'additionalProperties': False}