{
"message": "Meta Ads retrieved successfully",
"credits_consumed": 2.6,
"ads_count": 1,
"ads": [
[
{
"adid": "0",
"adArchiveID": "618153827656899",
"archiveTypes": [],
"categories": [
0
],
"containsDigitallyCreatedMedia": false,
"containsSensitiveContent": false,
"collationCount": 1,
"collationID": 1015196963820298,
"currency": "",
"endDate": 1741248000,
"entityType": "person_profile",
"fevInfo": null,
"finServAdData": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"gatedType": "eligible",
"hasUserReported": false,
"hiddenSafetyData": false,
"hideDataStatus": "NONE",
"impressionsWithIndex": {
"impressionsText": null,
"impressionsIndex": -1
},
"isAAAEligible": true,
"isAdAccountActioned": false,
"isActive": true,
"isProfilePage": false,
"pageID": "105549201674375",
"pageInfo": null,
"pageIsDeleted": false,
"pageName": "Lykkedal Retreat",
"politicalCountries": [],
"reachEstimate": null,
"regionalRegulationData": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"reportCount": null,
"snapshot": {
"ad_creative_id": 1159245568945589,
"cards": [],
"body_translations": {},
"byline": null,
"caption": "ezme.io",
"cta_text": "Buy tickets",
"dynamic_item_flags": {},
"dynamic_versions": null,
"edited_snapshots": [],
"effective_authorization_category": "NONE",
"event": {
"event_promoted_type": "external_tickets",
"event_start_timestamp": 1742130000,
"event_end_timestamp": 1742137200,
"event_location": "Dalvej 5, Helsinge",
"event_timezone": "Europe/Copenhagen"
},
"extra_images": [],
"extra_links": [],
"extra_texts": [],
"extra_videos": [],
"instagram_shopping_products": [],
"display_format": "event",
"title": "Yin Yoga & Yoga Nidra til LeadMagic",
"link_description": "Dalvej 5, Helsinge",
"link_url": "https://ezme.io/c/xHa/3KPb",
"page_welcome_message": null,
"images": [
{
"original_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/481787314_4001422706744378_5754827939445302437_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oLiF-cU0WxgQ7kNvgEM6GgD&_nc_oc=AdgH2C1dxKtFX8-Nb0xC8YJj9RAGxYUVx4s72-vlBMvSF8NqRSDRTgLtQ49bxn4GKvU&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYFCcwS06k5-Zs4REiVNPyDBnDiH2m3ry6__l8b-xYVnNw&oe=67D010D7",
"resized_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/482055202_1183219813458252_5286390622516633466_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UpMVtSZb0FoQ7kNvgGYCYSO&_nc_oc=AdioNK9N0BC6jFliPpZBoCB7q8c6RxzPm1sjxYyWN8gW1fEzj5ort06-PEXPS9aRQtY&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYET5FXrho887m4dU5OxwmVKM8nNNYMDyPzbcrFDRHPNkQ&oe=67CFD900",
"watermarked_resized_image_url": "",
"image_crops": {}
}
],
"videos": [],
"creation_time": 1741291804,
"page_id": 105549201674375,
"page_name": "Lykkedal Retreat",
"page_profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482021866_1335378004273354_6611332374691484765_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9OkGTrz7rR0Q7kNvgG57RTD&_nc_oc=AdhR7nxSqcwLeXf4E6zMven92LUORzNF9f6UG5HdXPkNcCJwnCvuJsEFIkd2qEkf1mc&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYHvvv7TVyYBBZbUWdFtsMMF1Zw19HFrCguT8PizFkDG-w&oe=67CFF9CB",
"page_categories": {
"1215982301785137": "Meditation Center"
},
"page_entity_type": "person_profile",
"page_is_profile_page": false,
"instagram_actor_name": "🔆 ET LIV I BALANCE 🔆",
"instagram_profile_pic_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482221977_1473904650233662_1812261223336634635_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pt8glJ939ioQ7kNvgEhv2uO&_nc_oc=Adi7fFY9dROfonTLhbM1HQhTr-sBDcj7xGQeKttehNVcjEKjKkBqWDm69xB9k8lQLk4&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYH7uq0g9Ag0DFiPvgZdXyt_1LXYO8ZrWuCq--rMrhWQfw&oe=67CFE12C",
"instagram_url": "",
"instagram_handle": "",
"is_reshared": false,
"version": 3,
"body": {
"context": {},
"markup": {
"__html": "🌿 Yin Yoga & LeadMagic Meditation i jurten på Lykkedal Retreat 🌿<br /> <br /> Trænger du til en dyb pause, hvor krop og sind får lov at give slip og finde ro? ✨<br /> <br /> 🧘♀️ Yin Yoga er en blid, meditativ yogaform, der arbejder med kroppens bindevæv, led og energibaner gennem lange, rolige stræk. Stillingerne holdes i flere minutter, så kroppen får tid til at slippe spændinger og finde dybere afslapning. Alle kan være med – uanset erfaring.<br /> <br /> 🎶 LeadMagic Meditation fordyber din afslapning gennem dybe, vibrerende lyde, der beroliger nervesystemet og inviterer sindet til at give slip. Mange oplever en følelse af lethed, ro og fornyet energi efter en meditation.<br /> <br /> 📅 Dato: Søndag d. 16. marts<br /> ⏰ Tid: Kl. 14:00 - 16:00<br /> 📍 Sted: Lykkedal Retreat, Dalvej 5, Helsinge<br /> Pris: 275 kr.<br /> <br /> 🌿 Efter workshoppen byder vi på økologisk urtete og lækre snacks i vores hyggelige skovcafé. Her kan du nyde en stille stund og mærke effekten af din praksis. Tag en mindful gåtur i naturen og hils på dyrene – en smuk måde at afslutte dagen på.<br /> <br /> 🔔 Alle er velkomne – uanset erfaring! 🔔<br /> <br /> 💚 Tilmelding & info:<br /> 📩 Send besked til Natassia på info@lykkedalretreat.dk eller tlf. 2390 7473<br /> <br /> 🌾 Lykkedal Retreat – en perle i Nordsjællands natur 🌾<br /> Her finder du åbne marker med heste, høje træer og den smukke gamle Pibe Mølle. Workshoppen afholdes i den stemningsfulde jurt/rundsal, hvor du kan fordybe dig i ro og nærvær.<br /> <br /> ✨ Tidligere deltagere siger:<br /> 🌟 "Lykkedal er et åndehul i naturen"<br /> 🌟 "Jeg kom hjem i mig selv"<br /> 🌟 "Jeg havde glemt, hvor meget jeg savner naturen"<br /> <br /> 📩 Book din plads i dag – vi glæder os til at byde dig velkommen!<br /> <br /> #YinYoga #LeadMagicMeditation #LykkedalRetreat #IndreRo #NaturligBalance #Mindfulness #Selvforkælelse #TidTilDigSelv"
},
"callerHash": "c339298372ed2a9ebf3ad02f136b05d2"
},
"brazil_tax_id": null,
"branded_content": null,
"current_page_name": "Lykkedal Retreat",
"disclaimer_label": null,
"page_like_count": 1198,
"page_profile_uri": "https://facebook.com/LykkedalRetreat",
"page_is_deleted": false,
"root_reshared_post": null,
"cta_type": "BUY_TICKETS",
"additional_info": null,
"ec_certificates": null,
"country_iso_code": null,
"instagram_branded_content": null
},
"spend": null,
"startDate": 1741248000,
"stateMediaRunLabel": null,
"publisherPlatform": [
"facebook",
"instagram"
],
"menuItems": [],
"targetedOrReachedCountries": [],
"totalActiveTime": 7915
}
]
]
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/validation_error",
"title": "Request validation failed. Check your input parameters.",
"status": 400,
"code": "validation_error",
"param": [
"email"
],
"detail": "Email format is invalid. Expected format: user@domain.com",
"action": "Provide a valid email address in the 'email' field.",
"docs": "https://leadmagic.io/docs/api-reference/errors"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/missing_authentication",
"title": "Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).",
"status": 401,
"code": "missing_authentication",
"docs": "https://leadmagic.io/docs/api-reference/authentication"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/insufficient_credits",
"title": "Insufficient credits: need 5, have 2.50. Add credits to continue.",
"status": 402,
"code": "insufficient_credits",
"detail": "This request requires 5 credit(s) but your account only has 2.50 credits remaining.",
"action": "Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.",
"docs": "https://leadmagic.io/docs/api-reference/credits",
"context": {
"credits_required": 5,
"credits_available": 2.5,
"credits_needed": 2.5
}
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/rate_limit_exceeded",
"title": "Rate limit exceeded: 300 requests per 1 minute. Wait and try again.",
"status": 429,
"code": "rate_limit_exceeded",
"detail": "You have exceeded the maximum allowed request rate. Please wait before making additional requests.",
"action": "Wait 42 seconds before retrying. Consider implementing exponential backoff.",
"docs": "https://leadmagic.io/docs/api-reference/rate-limits",
"context": {
"limit": 300,
"window": "1 minute",
"remaining": 0,
"reset_at": 1706745642,
"retry_after_seconds": 42
}
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/INTERNAL_ERROR",
"title": "Something went wrong on our end. Our team has been notified and is investigating.",
"status": 500,
"code": "INTERNAL_ERROR",
"detail": "This is a temporary server error. The issue has been automatically reported to our team.",
"action": "Wait 30 seconds and retry your request. If the problem persists, contact support@leadmagic.io",
"docs": "https://leadmagic.io/docs/api-reference/errors"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"message": "Meta Ads retrieved successfully",
"credits_consumed": 2.6,
"ads_count": 1,
"ads": [
[
{
"adid": "0",
"adArchiveID": "618153827656899",
"archiveTypes": [],
"categories": [
0
],
"containsDigitallyCreatedMedia": false,
"containsSensitiveContent": false,
"collationCount": 1,
"collationID": 1015196963820298,
"currency": "",
"endDate": 1741248000,
"entityType": "person_profile",
"fevInfo": null,
"finServAdData": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"gatedType": "eligible",
"hasUserReported": false,
"hiddenSafetyData": false,
"hideDataStatus": "NONE",
"impressionsWithIndex": {
"impressionsText": null,
"impressionsIndex": -1
},
"isAAAEligible": true,
"isAdAccountActioned": false,
"isActive": true,
"isProfilePage": false,
"pageID": "105549201674375",
"pageInfo": null,
"pageIsDeleted": false,
"pageName": "Lykkedal Retreat",
"politicalCountries": [],
"reachEstimate": null,
"regionalRegulationData": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"reportCount": null,
"snapshot": {
"ad_creative_id": 1159245568945589,
"cards": [],
"body_translations": {},
"byline": null,
"caption": "ezme.io",
"cta_text": "Buy tickets",
"dynamic_item_flags": {},
"dynamic_versions": null,
"edited_snapshots": [],
"effective_authorization_category": "NONE",
"event": {
"event_promoted_type": "external_tickets",
"event_start_timestamp": 1742130000,
"event_end_timestamp": 1742137200,
"event_location": "Dalvej 5, Helsinge",
"event_timezone": "Europe/Copenhagen"
},
"extra_images": [],
"extra_links": [],
"extra_texts": [],
"extra_videos": [],
"instagram_shopping_products": [],
"display_format": "event",
"title": "Yin Yoga & Yoga Nidra til LeadMagic",
"link_description": "Dalvej 5, Helsinge",
"link_url": "https://ezme.io/c/xHa/3KPb",
"page_welcome_message": null,
"images": [
{
"original_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/481787314_4001422706744378_5754827939445302437_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oLiF-cU0WxgQ7kNvgEM6GgD&_nc_oc=AdgH2C1dxKtFX8-Nb0xC8YJj9RAGxYUVx4s72-vlBMvSF8NqRSDRTgLtQ49bxn4GKvU&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYFCcwS06k5-Zs4REiVNPyDBnDiH2m3ry6__l8b-xYVnNw&oe=67D010D7",
"resized_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/482055202_1183219813458252_5286390622516633466_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UpMVtSZb0FoQ7kNvgGYCYSO&_nc_oc=AdioNK9N0BC6jFliPpZBoCB7q8c6RxzPm1sjxYyWN8gW1fEzj5ort06-PEXPS9aRQtY&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYET5FXrho887m4dU5OxwmVKM8nNNYMDyPzbcrFDRHPNkQ&oe=67CFD900",
"watermarked_resized_image_url": "",
"image_crops": {}
}
],
"videos": [],
"creation_time": 1741291804,
"page_id": 105549201674375,
"page_name": "Lykkedal Retreat",
"page_profile_picture_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482021866_1335378004273354_6611332374691484765_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=9OkGTrz7rR0Q7kNvgG57RTD&_nc_oc=AdhR7nxSqcwLeXf4E6zMven92LUORzNF9f6UG5HdXPkNcCJwnCvuJsEFIkd2qEkf1mc&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYHvvv7TVyYBBZbUWdFtsMMF1Zw19HFrCguT8PizFkDG-w&oe=67CFF9CB",
"page_categories": {
"1215982301785137": "Meditation Center"
},
"page_entity_type": "person_profile",
"page_is_profile_page": false,
"instagram_actor_name": "🔆 ET LIV I BALANCE 🔆",
"instagram_profile_pic_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482221977_1473904650233662_1812261223336634635_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pt8glJ939ioQ7kNvgEhv2uO&_nc_oc=Adi7fFY9dROfonTLhbM1HQhTr-sBDcj7xGQeKttehNVcjEKjKkBqWDm69xB9k8lQLk4&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=AxNB6smfEOXOGrm59sveePu&oh=00_AYH7uq0g9Ag0DFiPvgZdXyt_1LXYO8ZrWuCq--rMrhWQfw&oe=67CFE12C",
"instagram_url": "",
"instagram_handle": "",
"is_reshared": false,
"version": 3,
"body": {
"context": {},
"markup": {
"__html": "🌿 Yin Yoga & LeadMagic Meditation i jurten på Lykkedal Retreat 🌿<br /> <br /> Trænger du til en dyb pause, hvor krop og sind får lov at give slip og finde ro? ✨<br /> <br /> 🧘♀️ Yin Yoga er en blid, meditativ yogaform, der arbejder med kroppens bindevæv, led og energibaner gennem lange, rolige stræk. Stillingerne holdes i flere minutter, så kroppen får tid til at slippe spændinger og finde dybere afslapning. Alle kan være med – uanset erfaring.<br /> <br /> 🎶 LeadMagic Meditation fordyber din afslapning gennem dybe, vibrerende lyde, der beroliger nervesystemet og inviterer sindet til at give slip. Mange oplever en følelse af lethed, ro og fornyet energi efter en meditation.<br /> <br /> 📅 Dato: Søndag d. 16. marts<br /> ⏰ Tid: Kl. 14:00 - 16:00<br /> 📍 Sted: Lykkedal Retreat, Dalvej 5, Helsinge<br /> Pris: 275 kr.<br /> <br /> 🌿 Efter workshoppen byder vi på økologisk urtete og lækre snacks i vores hyggelige skovcafé. Her kan du nyde en stille stund og mærke effekten af din praksis. Tag en mindful gåtur i naturen og hils på dyrene – en smuk måde at afslutte dagen på.<br /> <br /> 🔔 Alle er velkomne – uanset erfaring! 🔔<br /> <br /> 💚 Tilmelding & info:<br /> 📩 Send besked til Natassia på info@lykkedalretreat.dk eller tlf. 2390 7473<br /> <br /> 🌾 Lykkedal Retreat – en perle i Nordsjællands natur 🌾<br /> Her finder du åbne marker med heste, høje træer og den smukke gamle Pibe Mølle. Workshoppen afholdes i den stemningsfulde jurt/rundsal, hvor du kan fordybe dig i ro og nærvær.<br /> <br /> ✨ Tidligere deltagere siger:<br /> 🌟 "Lykkedal er et åndehul i naturen"<br /> 🌟 "Jeg kom hjem i mig selv"<br /> 🌟 "Jeg havde glemt, hvor meget jeg savner naturen"<br /> <br /> 📩 Book din plads i dag – vi glæder os til at byde dig velkommen!<br /> <br /> #YinYoga #LeadMagicMeditation #LykkedalRetreat #IndreRo #NaturligBalance #Mindfulness #Selvforkælelse #TidTilDigSelv"
},
"callerHash": "c339298372ed2a9ebf3ad02f136b05d2"
},
"brazil_tax_id": null,
"branded_content": null,
"current_page_name": "Lykkedal Retreat",
"disclaimer_label": null,
"page_like_count": 1198,
"page_profile_uri": "https://facebook.com/LykkedalRetreat",
"page_is_deleted": false,
"root_reshared_post": null,
"cta_type": "BUY_TICKETS",
"additional_info": null,
"ec_certificates": null,
"country_iso_code": null,
"instagram_branded_content": null
},
"spend": null,
"startDate": 1741248000,
"stateMediaRunLabel": null,
"publisherPlatform": [
"facebook",
"instagram"
],
"menuItems": [],
"targetedOrReachedCountries": [],
"totalActiveTime": 7915
}
]
]
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/validation_error",
"title": "Request validation failed. Check your input parameters.",
"status": 400,
"code": "validation_error",
"param": [
"email"
],
"detail": "Email format is invalid. Expected format: user@domain.com",
"action": "Provide a valid email address in the 'email' field.",
"docs": "https://leadmagic.io/docs/api-reference/errors"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/missing_authentication",
"title": "Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).",
"status": 401,
"code": "missing_authentication",
"docs": "https://leadmagic.io/docs/api-reference/authentication"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/insufficient_credits",
"title": "Insufficient credits: need 5, have 2.50. Add credits to continue.",
"status": 402,
"code": "insufficient_credits",
"detail": "This request requires 5 credit(s) but your account only has 2.50 credits remaining.",
"action": "Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.",
"docs": "https://leadmagic.io/docs/api-reference/credits",
"context": {
"credits_required": 5,
"credits_available": 2.5,
"credits_needed": 2.5
}
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/rate_limit_exceeded",
"title": "Rate limit exceeded: 300 requests per 1 minute. Wait and try again.",
"status": 429,
"code": "rate_limit_exceeded",
"detail": "You have exceeded the maximum allowed request rate. Please wait before making additional requests.",
"action": "Wait 42 seconds before retrying. Consider implementing exponential backoff.",
"docs": "https://leadmagic.io/docs/api-reference/rate-limits",
"context": {
"limit": 300,
"window": "1 minute",
"remaining": 0,
"reset_at": 1706745642,
"retry_after_seconds": 42
}
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{
"success": false,
"errors": [
{
"type": "https://api.leadmagic.io/errors/INTERNAL_ERROR",
"title": "Something went wrong on our end. Our team has been notified and is investigating.",
"status": 500,
"code": "INTERNAL_ERROR",
"detail": "This is a temporary server error. The issue has been automatically reported to our team.",
"action": "Wait 30 seconds and retry your request. If the problem persists, contact support@leadmagic.io",
"docs": "https://leadmagic.io/docs/api-reference/errors"
}
],
"meta": {
"request_id": "ea6e3248-f4d2-437d-bca3-20881b529129",
"timestamp": "2024-02-01T12:00:00.000Z"
}
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"LeadMagic","description":"B2B data enrichment API for email validation, contact discovery, company intelligence, and advertising insights","colors":{"primary":"#7C3AED","light":"#C4B5FD","dark":"#7C3AED"},"logo":{"light":"https://mintcdn.com/leadmagic/_o4X9taQ-eKpmHvO/logo/light.svg?fit=max\u0026auto=format\u0026n=_o4X9taQ-eKpmHvO\u0026q=85\u0026s=586839aef34c6fa857b3a749aa11ec54","dark":"https://mintcdn.com/leadmagic/_o4X9taQ-eKpmHvO/logo/dark.svg?fit=max\u0026auto=format\u0026n=_o4X9taQ-eKpmHvO\u0026q=85\u0026s=cf0388099968331971afcdcdc8648869","href":"https://leadmagic.io"},"favicon":{"light":"https://mintcdn.com/leadmagic/1Av12g9mXy2gzZFP/favicon-light.png?fit=max\u0026auto=format\u0026n=1Av12g9mXy2gzZFP\u0026q=85\u0026s=95cb5828404ec3fba5f7b5e91e7c5ae6","dark":"https://mintcdn.com/leadmagic/1Av12g9mXy2gzZFP/favicon-dark.png?fit=max\u0026auto=format\u0026n=1Av12g9mXy2gzZFP\u0026q=85\u0026s=8e887b7f35826a27ab4c63ab698ae342"},"api":{"openapi":"v1/reference/openapi.yml","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","python","javascript","go","php"],"prefill":true}},"appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#fafafa","dark":"#09090b"}},"navbar":{"links":[{"href":"https://leadmagic.io/pricing","label":"Pricing"},{"href":"https://help.leadmagic.io/en","label":"Help Center"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.leadmagic.io/settings/api"}},"footer":{"socials":{"github":"https://github.com/LeadMagic","x":"https://x.com/leadmagichq","linkedin":"https://linkedin.com/company/leadmagichq","website":"https://leadmagic.io"},"links":[{"header":"Product","items":[{"label":"Pricing","href":"https://leadmagic.io/pricing"},{"label":"API Reference","href":"https://leadmagic.io/docs/v1/reference/introduction"},{"label":"Integrations","href":"https://leadmagic.io/docs/v1/integrations"},{"label":"Blog","href":"https://leadmagic.io/blog"}]},{"header":"Resources","items":[{"label":"Documentation","href":"https://leadmagic.io/docs/v1/introduction"},{"label":"MCP Server","href":"https://leadmagic.io/docs/mcp/introduction"},{"label":"CLI","href":"https://leadmagic.io/docs/cli/introduction"},{"label":"Compare Providers","href":"https://leadmagic.io/docs/v1/compare"},{"label":"Help Center","href":"https://help.leadmagic.io/en"}]},{"header":"Company","items":[{"label":"About","href":"https://leadmagic.io/company"},{"label":"Contact","href":"mailto:support@leadmagic.io"},{"label":"Privacy Policy","href":"https://leadmagic.io/legal/privacy"},{"label":"Terms of Service","href":"https://leadmagic.io/legal/terms"}]}]},"search":{"prompt":"Search docs..."},"seo":{"metatags":{"charset":"UTF-8","viewport":"width=device-width, initial-scale=1.0","robots":"index, follow","googlebot":"index, follow","author":"LeadMagic","theme-color":"#7C3AED","format-detection":"telephone=no","og:site_name":"LeadMagic API Documentation","og:type":"website","og:locale":"en_US","og:url":"https://leadmagic.io/docs","og:title":"LeadMagic API — B2B Data Enrichment Platform","og:description":"Enterprise-grade API for email validation, contact discovery, company intelligence, and competitive ad analysis. Trusted by sales teams worldwide.","og:image":"https://leadmagic.io/opengraph-image","twitter:card":"summary_large_image","twitter:site":"@leadmagichq","twitter:creator":"@leadmagichq","twitter:url":"https://leadmagic.io/docs","twitter:title":"LeadMagic API Documentation","twitter:description":"B2B data enrichment API for email validation, lead enrichment, mobile discovery, and company intelligence.","twitter:image":"https://leadmagic.io/opengraph-image"},"indexing":"navigable"},"fonts":{"family":"Geist"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"posthog":{"apiKey":"phc_1utSx7g2DAWKeUw1Km0axPF5OfedVblEcUQ6Lidy0XA","apiHost":"https://leadmagic.io/_lm"}},"errors":{"404":{"redirect":true,"title":"Page not found","description":"The page you are looking for does not exist."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"fonts":{"family":"Geist"}},"metadata":{"timestamp":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leadmagic","hasAudioNarration":false,"actualSubdomain":"leadmagic","customDomains":["leadmagic.io"],"gitSource":{"type":"github","owner":"leadmagic","repo":"leadmagic-website","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21a5c9d7ed34badbc2a1de","collectionId":"7856acfd-1504-4948-9256-f0bfcd9007a7","schemaVersion":"v2"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae9160617875ca6d2a2e024:success","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":36},{"language":"default","tag":"Jobs","count":15},{"language":"default","tag":"Get Started","count":9},{"language":"default","tag":"CLI","count":8},{"language":"default","tag":"Helpers","count":7},{"language":"default","tag":"MCP Server","count":5},{"language":"default","tag":"Email","count":5},{"language":"default","tag":"Filters","count":5},{"language":"default","tag":"Ads","count":4},{"language":"default","tag":"Company","count":4}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"698a3eb64eef7d933e5ba5f9","deploymentId":"646ae281576147f78ecc947c","questionText":"How do I validate email addresses?","status":"active","generatedBy":"manual","createdAt":"2026-02-09T20:08:22.342Z","updatedAt":"2026-02-09T20:08:22.342Z","__v":0},{"_id":"698a3eb44eef7d933e5ba5f0","deploymentId":"646ae281576147f78ecc947c","questionText":"What does each API call cost?","status":"active","generatedBy":"manual","createdAt":"2026-02-09T20:08:20.955Z","updatedAt":"2026-02-09T20:08:20.955Z","__v":0},{"_id":"698a3eb34eef7d933e5ba5d8","deploymentId":"646ae281576147f78ecc947c","questionText":"How do I get my API key?","status":"active","generatedBy":"manual","createdAt":"2026-02-09T20:08:19.423Z","updatedAt":"2026-02-09T20:08:19.423Z","__v":0}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"v1/reference/meta-ads-search","slug":"/v1/reference/meta-ads-search","pageMetadata":{"openapi":"post /v1/ads/meta-ads-search","og:title":"Meta Ads — LeadMagic","og:description":"POST — Meta Ads endpoint documentation for LeadMagic API.","twitter:title":"Meta Ads — LeadMagic","title":"Meta Ads Search","description":"Search for Meta Ads by company domain or name.","href":"/v1/reference/meta-ads-search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search for Meta Ads by company domain or name.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,CodeGroup,Heading,Info,ParamField,ResponseField,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`meta-ads`,children:`Meta Ads`}),`\n`,_jsx(_components.p,{children:`Search for Meta (Facebook/Instagram) ads run by a company. Analyze social media advertising strategies and creative approaches.`}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint-details`,children:`Endpoint Details`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Pricing`,icon:`coins`,id:`pricing`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Metric`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Cost`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`0.2 credits`}),` per search`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Calculation`})}),_jsx(_components.td,{children:`5 searches = 1 credit`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`No Results`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`FREE`}),` if no ads found`]})]})]})]}),_jsx(Tip,{children:_jsx(_components.p,{children:`Very cost-effective for social ad intelligence at just 0.2 credits per search.`})})]}),_jsxs(Tab,{title:`Rate Limits`,icon:`gauge`,id:`rate-limits`,\"data-child-heading-ids\":`[\"per-endpoint-limit\"]`,children:[_jsx(Heading,{level:`3`,id:`per-endpoint-limit`,children:`Per-Endpoint Limit`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Metric`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Requests/Minute`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:`300`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Burst Capacity`})}),_jsx(_components.td,{children:`~5 requests/second`})]})]})]}),_jsx(Info,{children:_jsxs(_components.p,{children:[`Rate limits are subject to change. Custom rate limits are available on enterprise plans — `,_jsx(_components.a,{href:`mailto:support@leadmagic.io`,children:`contact us`}),`.`]})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`quick-example`,children:`Quick Example`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`curl`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -X`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` POST`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'https://api.leadmagic.io/v1/ads/meta-ads-search'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'X-API-Key: YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` -d`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` '{\"company_domain\": \"leadmagic.io\"}'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`10`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` response`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` await`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:` fetch`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'https://api.leadmagic.io/v1/ads/meta-ads-search'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` method: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'POST'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` headers: {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'X-API-Key'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'application/json'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` body: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`JSON`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`stringify`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`({ company_domain: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'leadmagic.io'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` })`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`const`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` data`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` =`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` await`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` response.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`json`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`console.`}),_jsx(_components.span,{style:{color:`#6F42C1`,\"--shiki-dark\":`#B392F0`},children:`log`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:\"`Found ${\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`data`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`.`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`ads`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`?.`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`length`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:` ||`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` 0`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:\"} Meta ads`\"}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`);`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`9`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`import`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`response `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` 'https://api.leadmagic.io/v1/ads/meta-ads-search'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` headers`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'X-API-Key'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#E36209`,\"--shiki-dark\":`#FFAB70`},children:` json`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'company_domain'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'leadmagic.io'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`data `}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`=`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` response.json()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`print`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(`}),_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`f`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Found `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`{len`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`(data.get(`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`'ads'`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`, []))`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`}`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` Meta ads\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`)`})]}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`request-parameters`,children:`Request Parameters`}),`\n`,_jsx(ParamField,{body:`company_domain`,type:`string`,id:`param-company-domain`,children:_jsx(_components.p,{children:`Company website domain (preferred).`})}),`\n`,_jsx(ParamField,{body:`company_name`,type:`string`,id:`param-company-name`,children:_jsx(_components.p,{children:`Company name.`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`You must provide either `,_jsx(_components.code,{children:`company_domain`}),` or `,_jsx(_components.code,{children:`company_name`}),` (or both).`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`company_name`,type:`string`,required:true,id:`param-company-name-1`,children:_jsx(_components.p,{children:`Company searched`})}),`\n`,_jsx(ResponseField,{name:`ads`,type:`array`,required:true,id:`param-ads`,children:_jsx(_components.p,{children:`Array of ad creatives`})}),`\n`,_jsx(ResponseField,{name:`credits_consumed`,type:`number`,required:true,id:`param-credits-consumed`,children:_jsx(_components.p,{children:`Credits used (0.2 if found, 0 if not)`})}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,required:true,id:`param-message`,children:_jsx(_components.p,{children:`Human-readable status message`})}),`\n`,_jsx(Heading,{level:`3`,id:`ad-object`,children:`Ad Object`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ad_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Meta Ad Library ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`content`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Ad copy/text`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`image_url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Ad image URL`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`video_url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Ad video URL (if video ad)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`platform`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Facebook, Instagram, or both`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`started_running`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`When ad started`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"company_name\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Airbnb\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"ads\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"ad_id\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"123456789\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Book unique homes and experiences all over the world.\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"image_url\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"https://...\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"platform\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Facebook, Instagram\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"started_running\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"2026-01-15\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"credits_consumed\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`0.2`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"Ads found.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`success-messages`,children:`Success Messages`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Message`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Cost`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Ads found.`})}),_jsx(_components.td,{children:`Meta Ads data returned`}),_jsx(_components.td,{children:`0.2 credits`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`No ads found for this company.`})}),_jsx(_components.td,{children:`No Meta Ads found`}),_jsx(_components.td,{children:`FREE`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Analyze visual creative`,icon:`image`,id:`analyze-visual-creative`,children:_jsx(_components.p,{children:`Meta ads are highly visual. Study image styles and video formats.`})}),_jsx(Accordion,{title:`Note platform targeting`,icon:`bullseye`,id:`note-platform-targeting`,children:_jsx(_components.p,{children:`See which platforms (Facebook vs Instagram) competitors prioritize.`})}),_jsx(Accordion,{title:`Track seasonal campaigns`,icon:`calendar`,id:`track-seasonal-campaigns`,children:_jsx(_components.p,{children:`Monitor how competitors adjust messaging for seasons and events.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Creative Inspiration`,icon:`palette`,children:_jsx(_components.p,{children:`Study competitor visual styles and messaging.`})}),_jsx(Card,{title:`Competitive Intelligence`,icon:`binoculars`,children:_jsx(_components.p,{children:`Monitor competitor social ad strategies.`})}),_jsx(Card,{title:`Market Research`,icon:`chart-pie`,children:_jsx(_components.p,{children:`Analyze social advertising trends in your industry.`})}),_jsx(Card,{title:`Campaign Planning`,icon:`calendar`,children:_jsx(_components.p,{children:`Inform your own social ad strategy with competitor insights.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"openapi":"post /v1/ads/meta-ads-search","og:title":"Meta Ads — LeadMagic","og:description":"POST — Meta Ads endpoint documentation for LeadMagic API.","twitter:title":"Meta Ads — LeadMagic","title":"Meta Ads Search","description":"Search for Meta Ads by company domain or name.","href":"/v1/reference/meta-ads-search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Meta Ads","slug":"meta-ads","depth":1,"children":[]},{"title":"Endpoint Details","slug":"endpoint-details","depth":2,"children":[{"title":"Per-Endpoint Limit","slug":"per-endpoint-limit","depth":3,"children":[],"tabId":"rate-limits"}]},{"title":"Quick Example","slug":"quick-example","depth":2,"children":[]},{"title":"Request Parameters","slug":"request-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Ad Object","slug":"ad-object","depth":3,"children":[]},{"title":"Example Response","slug":"example-response","depth":3,"children":[]}]},{"title":"Success Messages","slug":"success-messages","depth":2,"children":[]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/leadmagic/5f1670b4f287f961/analytics-first-party.js"],"openApiReferenceData":{"operation":{"summary":"Meta Ads Search","description":"Search for Meta Ads by company domain or name.","operationId":"meta-ads-search","tags":["Ads Data"],"requestBody":"30a48564-3bc0-4009-ad54-3354d17835d4","responses":{"200":"608ea11b-d17f-499b-9838-4a499c8a0e5d","400":"56525230-2856-4b54-a524-070af9ae8018","401":"7ed7144d-c4a4-4c8e-9ae0-7d4b279c586a","402":"5acbc51a-2ee9-4669-82dd-e38ab336908c","429":"9c85f566-0b9a-4c65-b14f-a7a5da110021","500":"0260d369-9ede-4428-94e4-ce00f5ac7dc2"},"method":"post","type":"path","servers":["132f8068-ade7-4442-8c67-2b3abf0d6ed1"],"security":["1878ab7c-6585-47d3-aa53-7cc62cb86057"],"path":"/v1/ads/meta-ads-search","baseUrlOptions":["https://api.leadmagic.io"],"title":"Meta Ads Search","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go","php"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.company_domain":"leadmagic.io","body.company_name":"leadmagic"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"company_domain":{"type":"string","description":"Company domain name","default":"leadmagic.io","example":"leadmagic.io","uniqueKey":"company_domain","typeLabel":"string"},"company_name":{"type":"string","description":"Company name","default":"leadmagic","example":"leadmagic","uniqueKey":"company_name","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"company_domain":"leadmagic.io","company_name":"leadmagic"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"608ea11b-d17f-499b-9838-4a499c8a0e5d":{"description":"Successful response with ads details","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Meta Ads retrieved successfully","uniqueKey":"message","typeLabel":"string"},"credits_consumed":{"type":"number","example":2.6,"uniqueKey":"credits_consumed","typeLabel":"number"},"ads_count":{"type":"integer","example":1,"uniqueKey":"ads_count","typeLabel":"integer"},"ads":{"type":"array","description":"Array of ad objects (structure varies by ad type)","items":{"type":"object","uniqueKey":"ads.items.[INDEX]","typeLabel":"object"},"uniqueKey":"ads","typeLabel":"object[]"}},"example":{"message":"Meta Ads retrieved successfully","credits_consumed":2.6,"ads_count":1,"ads":[[{"adid":"0","adArchiveID":"618153827656899","archiveTypes":[],"categories":[0],"containsDigitallyCreatedMedia":false,"containsSensitiveContent":false,"collationCount":1,"collationID":1015196963820298,"currency":"","endDate":1741248000,"entityType":"person_profile","fevInfo":null,"finServAdData":{"is_deemed_finserv":false,"is_limited_delivery":false},"gatedType":"eligible","hasUserReported":false,"hiddenSafetyData":false,"hideDataStatus":"NONE","impressionsWithIndex":{"impressionsText":null,"impressionsIndex":-1},"isAAAEligible":true,"isAdAccountActioned":false,"isActive":true,"isProfilePage":false,"pageID":"105549201674375","pageInfo":null,"pageIsDeleted":false,"pageName":"Lykkedal Retreat","politicalCountries":[],"reachEstimate":null,"regionalRegulationData":{"finserv":{"is_deemed_finserv":false,"is_limited_delivery":false},"tw_anti_scam":{"is_limited_delivery":false}},"reportCount":null,"snapshot":{"ad_creative_id":1159245568945589,"cards":[],"body_translations":{},"byline":null,"caption":"ezme.io","cta_text":"Buy tickets","dynamic_item_flags":{},"dynamic_versions":null,"edited_snapshots":[],"effective_authorization_category":"NONE","event":{"event_promoted_type":"external_tickets","event_start_timestamp":1742130000,"event_end_timestamp":1742137200,"event_location":"Dalvej 5, Helsinge","event_timezone":"Europe/Copenhagen"},"extra_images":[],"extra_links":[],"extra_texts":[],"extra_videos":[],"instagram_shopping_products":[],"display_format":"event","title":"Yin Yoga \u0026 Yoga Nidra til LeadMagic","link_description":"Dalvej 5, Helsinge","link_url":"https://ezme.io/c/xHa/3KPb","page_welcome_message":null,"images":[{"original_image_url":"https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/481787314_4001422706744378_5754827939445302437_n.jpg?_nc_cat=111\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=oLiF-cU0WxgQ7kNvgEM6GgD\u0026_nc_oc=AdgH2C1dxKtFX8-Nb0xC8YJj9RAGxYUVx4s72-vlBMvSF8NqRSDRTgLtQ49bxn4GKvU\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-2.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYFCcwS06k5-Zs4REiVNPyDBnDiH2m3ry6__l8b-xYVnNw\u0026oe=67D010D7","resized_image_url":"https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/482055202_1183219813458252_5286390622516633466_n.jpg?stp=dst-jpg_s600x600_tt6\u0026_nc_cat=106\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=UpMVtSZb0FoQ7kNvgGYCYSO\u0026_nc_oc=AdioNK9N0BC6jFliPpZBoCB7q8c6RxzPm1sjxYyWN8gW1fEzj5ort06-PEXPS9aRQtY\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-2.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYET5FXrho887m4dU5OxwmVKM8nNNYMDyPzbcrFDRHPNkQ\u0026oe=67CFD900","watermarked_resized_image_url":"","image_crops":{}}],"videos":[],"creation_time":1741291804,"page_id":105549201674375,"page_name":"Lykkedal Retreat","page_profile_picture_url":"https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482021866_1335378004273354_6611332374691484765_n.jpg?stp=dst-jpg_s60x60_tt6\u0026_nc_cat=107\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=9OkGTrz7rR0Q7kNvgG57RTD\u0026_nc_oc=AdhR7nxSqcwLeXf4E6zMven92LUORzNF9f6UG5HdXPkNcCJwnCvuJsEFIkd2qEkf1mc\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-1.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYHvvv7TVyYBBZbUWdFtsMMF1Zw19HFrCguT8PizFkDG-w\u0026oe=67CFF9CB","page_categories":{"1215982301785137":"Meditation Center"},"page_entity_type":"person_profile","page_is_profile_page":false,"instagram_actor_name":"🔆 ET LIV I BALANCE 🔆","instagram_profile_pic_url":"https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482221977_1473904650233662_1812261223336634635_n.jpg?_nc_cat=102\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=pt8glJ939ioQ7kNvgEhv2uO\u0026_nc_oc=Adi7fFY9dROfonTLhbM1HQhTr-sBDcj7xGQeKttehNVcjEKjKkBqWDm69xB9k8lQLk4\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-1.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYH7uq0g9Ag0DFiPvgZdXyt_1LXYO8ZrWuCq--rMrhWQfw\u0026oe=67CFE12C","instagram_url":"","instagram_handle":"","is_reshared":false,"version":3,"body":{"context":{},"markup":{"__html":"🌿 Yin Yoga \u0026amp; LeadMagic Meditation i jurten på Lykkedal Retreat 🌿\u003cbr /> \u003cbr /> Trænger du til en dyb pause, hvor krop og sind får lov at give slip og finde ro? ✨\u003cbr /> \u003cbr /> 🧘♀️ Yin Yoga er en blid, meditativ yogaform, der arbejder med kroppens bindevæv, led og energibaner gennem lange, rolige stræk. Stillingerne holdes i flere minutter, så kroppen får tid til at slippe spændinger og finde dybere afslapning. Alle kan være med – uanset erfaring.\u003cbr /> \u003cbr /> 🎶 LeadMagic Meditation fordyber din afslapning gennem dybe, vibrerende lyde, der beroliger nervesystemet og inviterer sindet til at give slip. Mange oplever en følelse af lethed, ro og fornyet energi efter en meditation.\u003cbr /> \u003cbr /> 📅 Dato: Søndag d. 16. marts\u003cbr /> ⏰ Tid: Kl. 14:00 - 16:00\u003cbr /> 📍 Sted: Lykkedal Retreat, Dalvej 5, Helsinge\u003cbr /> Pris: 275 kr.\u003cbr /> \u003cbr /> 🌿 Efter workshoppen byder vi på økologisk urtete og lækre snacks i vores hyggelige skovcafé. Her kan du nyde en stille stund og mærke effekten af din praksis. Tag en mindful gåtur i naturen og hils på dyrene – en smuk måde at afslutte dagen på.\u003cbr /> \u003cbr /> 🔔 Alle er velkomne – uanset erfaring! 🔔\u003cbr /> \u003cbr /> 💚 Tilmelding \u0026amp; info:\u003cbr /> 📩 Send besked til Natassia på info\u0026#064;lykkedalretreat.dk eller tlf. 2390 7473\u003cbr /> \u003cbr /> 🌾 Lykkedal Retreat – en perle i Nordsjællands natur 🌾\u003cbr /> Her finder du åbne marker med heste, høje træer og den smukke gamle Pibe Mølle. Workshoppen afholdes i den stemningsfulde jurt/rundsal, hvor du kan fordybe dig i ro og nærvær.\u003cbr /> \u003cbr /> ✨ Tidligere deltagere siger:\u003cbr /> 🌟 \u0026quot;Lykkedal er et åndehul i naturen\u0026quot;\u003cbr /> 🌟 \u0026quot;Jeg kom hjem i mig selv\u0026quot;\u003cbr /> 🌟 \u0026quot;Jeg havde glemt, hvor meget jeg savner naturen\u0026quot;\u003cbr /> \u003cbr /> 📩 Book din plads i dag – vi glæder os til at byde dig velkommen!\u003cbr /> \u003cbr /> #YinYoga #LeadMagicMeditation #LykkedalRetreat #IndreRo #NaturligBalance #Mindfulness #Selvforkælelse #TidTilDigSelv"},"callerHash":"c339298372ed2a9ebf3ad02f136b05d2"},"brazil_tax_id":null,"branded_content":null,"current_page_name":"Lykkedal Retreat","disclaimer_label":null,"page_like_count":1198,"page_profile_uri":"https://facebook.com/LykkedalRetreat","page_is_deleted":false,"root_reshared_post":null,"cta_type":"BUY_TICKETS","additional_info":null,"ec_certificates":null,"country_iso_code":null,"instagram_branded_content":null},"spend":null,"startDate":1741248000,"stateMediaRunLabel":null,"publisherPlatform":["facebook","instagram"],"menuItems":[],"targetedOrReachedCountries":[],"totalActiveTime":7915}]]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Meta Ads retrieved successfully","credits_consumed":2.6,"ads_count":1,"ads":[[{"adid":"0","adArchiveID":"618153827656899","archiveTypes":[],"categories":[0],"containsDigitallyCreatedMedia":false,"containsSensitiveContent":false,"collationCount":1,"collationID":1015196963820298,"currency":"","endDate":1741248000,"entityType":"person_profile","fevInfo":null,"finServAdData":{"is_deemed_finserv":false,"is_limited_delivery":false},"gatedType":"eligible","hasUserReported":false,"hiddenSafetyData":false,"hideDataStatus":"NONE","impressionsWithIndex":{"impressionsText":null,"impressionsIndex":-1},"isAAAEligible":true,"isAdAccountActioned":false,"isActive":true,"isProfilePage":false,"pageID":"105549201674375","pageInfo":null,"pageIsDeleted":false,"pageName":"Lykkedal Retreat","politicalCountries":[],"reachEstimate":null,"regionalRegulationData":{"finserv":{"is_deemed_finserv":false,"is_limited_delivery":false},"tw_anti_scam":{"is_limited_delivery":false}},"reportCount":null,"snapshot":{"ad_creative_id":1159245568945589,"cards":[],"body_translations":{},"byline":null,"caption":"ezme.io","cta_text":"Buy tickets","dynamic_item_flags":{},"dynamic_versions":null,"edited_snapshots":[],"effective_authorization_category":"NONE","event":{"event_promoted_type":"external_tickets","event_start_timestamp":1742130000,"event_end_timestamp":1742137200,"event_location":"Dalvej 5, Helsinge","event_timezone":"Europe/Copenhagen"},"extra_images":[],"extra_links":[],"extra_texts":[],"extra_videos":[],"instagram_shopping_products":[],"display_format":"event","title":"Yin Yoga \u0026 Yoga Nidra til LeadMagic","link_description":"Dalvej 5, Helsinge","link_url":"https://ezme.io/c/xHa/3KPb","page_welcome_message":null,"images":[{"original_image_url":"https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/481787314_4001422706744378_5754827939445302437_n.jpg?_nc_cat=111\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=oLiF-cU0WxgQ7kNvgEM6GgD\u0026_nc_oc=AdgH2C1dxKtFX8-Nb0xC8YJj9RAGxYUVx4s72-vlBMvSF8NqRSDRTgLtQ49bxn4GKvU\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-2.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYFCcwS06k5-Zs4REiVNPyDBnDiH2m3ry6__l8b-xYVnNw\u0026oe=67D010D7","resized_image_url":"https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/482055202_1183219813458252_5286390622516633466_n.jpg?stp=dst-jpg_s600x600_tt6\u0026_nc_cat=106\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=UpMVtSZb0FoQ7kNvgGYCYSO\u0026_nc_oc=AdioNK9N0BC6jFliPpZBoCB7q8c6RxzPm1sjxYyWN8gW1fEzj5ort06-PEXPS9aRQtY\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-2.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYET5FXrho887m4dU5OxwmVKM8nNNYMDyPzbcrFDRHPNkQ\u0026oe=67CFD900","watermarked_resized_image_url":"","image_crops":{}}],"videos":[],"creation_time":1741291804,"page_id":105549201674375,"page_name":"Lykkedal Retreat","page_profile_picture_url":"https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482021866_1335378004273354_6611332374691484765_n.jpg?stp=dst-jpg_s60x60_tt6\u0026_nc_cat=107\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=9OkGTrz7rR0Q7kNvgG57RTD\u0026_nc_oc=AdhR7nxSqcwLeXf4E6zMven92LUORzNF9f6UG5HdXPkNcCJwnCvuJsEFIkd2qEkf1mc\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-1.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYHvvv7TVyYBBZbUWdFtsMMF1Zw19HFrCguT8PizFkDG-w\u0026oe=67CFF9CB","page_categories":{"1215982301785137":"Meditation Center"},"page_entity_type":"person_profile","page_is_profile_page":false,"instagram_actor_name":"🔆 ET LIV I BALANCE 🔆","instagram_profile_pic_url":"https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/482221977_1473904650233662_1812261223336634635_n.jpg?_nc_cat=102\u0026ccb=1-7\u0026_nc_sid=c53f8f\u0026_nc_ohc=pt8glJ939ioQ7kNvgEhv2uO\u0026_nc_oc=Adi7fFY9dROfonTLhbM1HQhTr-sBDcj7xGQeKttehNVcjEKjKkBqWDm69xB9k8lQLk4\u0026_nc_zt=14\u0026_nc_ht=scontent-iad3-1.xx\u0026_nc_gid=AxNB6smfEOXOGrm59sveePu\u0026oh=00_AYH7uq0g9Ag0DFiPvgZdXyt_1LXYO8ZrWuCq--rMrhWQfw\u0026oe=67CFE12C","instagram_url":"","instagram_handle":"","is_reshared":false,"version":3,"body":{"context":{},"markup":{"__html":"🌿 Yin Yoga \u0026amp; LeadMagic Meditation i jurten på Lykkedal Retreat 🌿\u003cbr /> \u003cbr /> Trænger du til en dyb pause, hvor krop og sind får lov at give slip og finde ro? ✨\u003cbr /> \u003cbr /> 🧘♀️ Yin Yoga er en blid, meditativ yogaform, der arbejder med kroppens bindevæv, led og energibaner gennem lange, rolige stræk. Stillingerne holdes i flere minutter, så kroppen får tid til at slippe spændinger og finde dybere afslapning. Alle kan være med – uanset erfaring.\u003cbr /> \u003cbr /> 🎶 LeadMagic Meditation fordyber din afslapning gennem dybe, vibrerende lyde, der beroliger nervesystemet og inviterer sindet til at give slip. Mange oplever en følelse af lethed, ro og fornyet energi efter en meditation.\u003cbr /> \u003cbr /> 📅 Dato: Søndag d. 16. marts\u003cbr /> ⏰ Tid: Kl. 14:00 - 16:00\u003cbr /> 📍 Sted: Lykkedal Retreat, Dalvej 5, Helsinge\u003cbr /> Pris: 275 kr.\u003cbr /> \u003cbr /> 🌿 Efter workshoppen byder vi på økologisk urtete og lækre snacks i vores hyggelige skovcafé. Her kan du nyde en stille stund og mærke effekten af din praksis. Tag en mindful gåtur i naturen og hils på dyrene – en smuk måde at afslutte dagen på.\u003cbr /> \u003cbr /> 🔔 Alle er velkomne – uanset erfaring! 🔔\u003cbr /> \u003cbr /> 💚 Tilmelding \u0026amp; info:\u003cbr /> 📩 Send besked til Natassia på info\u0026#064;lykkedalretreat.dk eller tlf. 2390 7473\u003cbr /> \u003cbr /> 🌾 Lykkedal Retreat – en perle i Nordsjællands natur 🌾\u003cbr /> Her finder du åbne marker med heste, høje træer og den smukke gamle Pibe Mølle. Workshoppen afholdes i den stemningsfulde jurt/rundsal, hvor du kan fordybe dig i ro og nærvær.\u003cbr /> \u003cbr /> ✨ Tidligere deltagere siger:\u003cbr /> 🌟 \u0026quot;Lykkedal er et åndehul i naturen\u0026quot;\u003cbr /> 🌟 \u0026quot;Jeg kom hjem i mig selv\u0026quot;\u003cbr /> 🌟 \u0026quot;Jeg havde glemt, hvor meget jeg savner naturen\u0026quot;\u003cbr /> \u003cbr /> 📩 Book din plads i dag – vi glæder os til at byde dig velkommen!\u003cbr /> \u003cbr /> #YinYoga #LeadMagicMeditation #LykkedalRetreat #IndreRo #NaturligBalance #Mindfulness #Selvforkælelse #TidTilDigSelv"},"callerHash":"c339298372ed2a9ebf3ad02f136b05d2"},"brazil_tax_id":null,"branded_content":null,"current_page_name":"Lykkedal Retreat","disclaimer_label":null,"page_like_count":1198,"page_profile_uri":"https://facebook.com/LykkedalRetreat","page_is_deleted":false,"root_reshared_post":null,"cta_type":"BUY_TICKETS","additional_info":null,"ec_certificates":null,"country_iso_code":null,"instagram_branded_content":null},"spend":null,"startDate":1741248000,"stateMediaRunLabel":null,"publisherPlatform":["facebook","instagram"],"menuItems":[],"targetedOrReachedCountries":[],"totalActiveTime":7915}]]}}},"exampleType":"generated"}},"exampleType":"generated"},"56525230-2856-4b54-a524-070af9ae8018":{"description":"Bad Request - The request was malformed or contains invalid parameters.\n\n**Common causes:**\n- Missing required fields\n- Invalid field format (e.g., malformed email)\n- Invalid JSON syntax\n- Invalid parameter values\n","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/validation_error","title":"Request validation failed. Check your input parameters.","status":400,"code":"validation_error","param":["email"],"detail":"Email format is invalid. Expected format: user@domain.com","action":"Provide a valid email address in the 'email' field.","docs":"https://leadmagic.io/docs/api-reference/errors"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"meta.environment","typeLabel":"string"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/validation_error","title":"Request validation failed. Check your input parameters.","status":400,"code":"validation_error","param":["email"],"detail":"Email format is invalid. Expected format: user@domain.com","action":"Provide a valid email address in the 'email' field.","docs":"https://leadmagic.io/docs/api-reference/errors"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7ed7144d-c4a4-4c8e-9ae0-7d4b279c586a":{"description":"Unauthorized - Authentication failed.\n\n**Common causes:**\n- Missing X-API-Key header\n- Invalid or expired API key\n- Malformed API key\n","content":{"application/problem+json":{"schema":{"oneOf":[{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/missing_authentication","title":"Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).","status":401,"code":"missing_authentication","docs":"https://leadmagic.io/docs/api-reference/authentication"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"oneOf.0.success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"oneOf.0.errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"oneOf.0.errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"oneOf.0.errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"oneOf.0.errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"oneOf.0.errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"oneOf.0.errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"oneOf.0.errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"oneOf.0.errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"oneOf.0.errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"oneOf.0.meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"oneOf.0.meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"oneOf.0.meta.environment","typeLabel":"string"}},"uniqueKey":"oneOf.0.meta","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/invalid_api_key","title":"Invalid API key. The key does not exist or is incorrect.","status":401,"code":"invalid_api_key","docs":"https://leadmagic.io/docs/api-reference/authentication"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"oneOf.1.success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"oneOf.1.errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"oneOf.1.errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"oneOf.1.errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"oneOf.1.errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"oneOf.1.errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"oneOf.1.errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"oneOf.1.errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"oneOf.1.errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"oneOf.1.meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"oneOf.1.meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"oneOf.1.meta.environment","typeLabel":"string"}},"uniqueKey":"oneOf.1.meta","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/missing_authentication","title":"Authentication required. Provide a valid API key in the X-API-Key header (case-insensitive).","status":401,"code":"missing_authentication","docs":"https://leadmagic.io/docs/api-reference/authentication"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5acbc51a-2ee9-4669-82dd-e38ab336908c":{"description":"Payment Required - Insufficient credits for this request.\n\n**Action required:** Add credits to your account at https://app.leadmagic.io/billing\n","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/insufficient_credits","title":"Insufficient credits: need 5, have 2.50. Add credits to continue.","status":402,"code":"insufficient_credits","detail":"This request requires 5 credit(s) but your account only has 2.50 credits remaining.","action":"Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.","docs":"https://leadmagic.io/docs/api-reference/credits","context":{"credits_required":5,"credits_available":2.5,"credits_needed":2.5}}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"meta.environment","typeLabel":"string"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/insufficient_credits","title":"Insufficient credits: need 5, have 2.50. Add credits to continue.","status":402,"code":"insufficient_credits","detail":"This request requires 5 credit(s) but your account only has 2.50 credits remaining.","action":"Add credits to your account at https://app.leadmagic.io/billing or contact support@leadmagic.io for enterprise plans.","docs":"https://leadmagic.io/docs/api-reference/credits","context":{"credits_required":5,"credits_available":2.5,"credits_needed":2.5}}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9c85f566-0b9a-4c65-b14f-a7a5da110021":{"description":"Too Many Requests - Rate limit exceeded.\n\n**Action required:** Check the `Retry-After` header for when to retry.\n\n**Headers returned:**\n- `Retry-After`: Seconds until you can retry\n- `RateLimit-Limit`: Your limit per minute\n- `RateLimit-Remaining`: Remaining requests this minute\n- `RateLimit-Reset`: Seconds until limit resets\n","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying"},"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Maximum requests per minute"},"RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Remaining requests this minute"},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until limit resets"}},"content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/rate_limit_exceeded","title":"Rate limit exceeded: 300 requests per 1 minute. Wait and try again.","status":429,"code":"rate_limit_exceeded","detail":"You have exceeded the maximum allowed request rate. Please wait before making additional requests.","action":"Wait 42 seconds before retrying. Consider implementing exponential backoff.","docs":"https://leadmagic.io/docs/api-reference/rate-limits","context":{"limit":300,"window":"1 minute","remaining":0,"reset_at":1706745642,"retry_after_seconds":42}}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"meta.environment","typeLabel":"string"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/rate_limit_exceeded","title":"Rate limit exceeded: 300 requests per 1 minute. Wait and try again.","status":429,"code":"rate_limit_exceeded","detail":"You have exceeded the maximum allowed request rate. Please wait before making additional requests.","action":"Wait 42 seconds before retrying. Consider implementing exponential backoff.","docs":"https://leadmagic.io/docs/api-reference/rate-limits","context":{"limit":300,"window":"1 minute","remaining":0,"reset_at":1706745642,"retry_after_seconds":42}}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0260d369-9ede-4428-94e4-ce00f5ac7dc2":{"description":"Internal Server Error - Something went wrong on our end.\n\n**Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io\n","content":{"application/problem+json":{"schema":{"type":"object","description":"RFC 9457 Problem Details error response","required":["success","errors"],"example":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/INTERNAL_ERROR","title":"Something went wrong on our end. Our team has been notified and is investigating.","status":500,"code":"INTERNAL_ERROR","detail":"This is a temporary server error. The issue has been automatically reported to our team.","action":"Wait 30 seconds and retry your request. If the problem persists, contact support@leadmagic.io","docs":"https://leadmagic.io/docs/api-reference/errors"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}},"properties":{"success":{"type":"boolean","example":false,"description":"Always false for error responses","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"errors":{"type":"array","description":"Array of error details (typically one, but can be multiple)","items":{"type":"object","description":"RFC 9457 compliant error detail","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"RFC 9457 - URI reference identifying the error type","example":"https://api.leadmagic.io/errors/validation_error","isRequired":true,"uniqueKey":"errors.items.[INDEX].type","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"RFC 9457 - Short human-readable summary","example":"Request validation failed. Check your input parameters.","isRequired":true,"uniqueKey":"errors.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","description":"RFC 9457 - HTTP status code","example":400,"isRequired":true,"uniqueKey":"errors.items.[INDEX].status","typeLabel":"integer"},"detail":{"type":"string","description":"RFC 9457 - Human-readable explanation specific to this occurrence","example":"The email field is required but was not provided.","uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"RFC 9457 - URI reference for this specific occurrence","example":"/v1/people/email-validation#req_abc123","uniqueKey":"errors.items.[INDEX].instance","typeLabel":"string\u003curi>"},"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"validation_error","uniqueKey":"errors.items.[INDEX].code","typeLabel":"string"},"param":{"type":"array","description":"Parameters that caused the error","items":{"type":"string","uniqueKey":"errors.items.[INDEX].param.items.[INDEX]","typeLabel":"string"},"example":["email"],"uniqueKey":"errors.items.[INDEX].param","typeLabel":"string[]"},"action":{"type":"string","description":"Suggested action to resolve the error","example":"Provide a valid email address in the 'email' field.","uniqueKey":"errors.items.[INDEX].action","typeLabel":"string"},"docs":{"type":"string","format":"uri","description":"Link to relevant documentation","example":"https://leadmagic.io/docs/api-reference/errors","uniqueKey":"errors.items.[INDEX].docs","typeLabel":"string\u003curi>"},"context":{"type":"object","description":"Additional context specific to this error type","additionalProperties":true,"uniqueKey":"errors.items.[INDEX].context","typeLabel":"object"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"},"meta":{"type":"object","description":"Metadata included in all responses","properties":{"request_id":{"type":"string","format":"uuid","description":"Unique identifier for this request (use for debugging/support)","example":"ea6e3248-f4d2-437d-bca3-20881b529129","uniqueKey":"meta.request_id","typeLabel":"string\u003cuuid>"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the response was generated","example":"2024-02-01T12:00:00.000Z","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","description":"API environment (production, staging)","example":"production","uniqueKey":"meta.environment","typeLabel":"string"}},"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"type":"https://api.leadmagic.io/errors/INTERNAL_ERROR","title":"Something went wrong on our end. Our team has been notified and is investigating.","status":500,"code":"INTERNAL_ERROR","detail":"This is a temporary server error. The issue has been automatically reported to our team.","action":"Wait 30 seconds and retry your request. If the problem persists, contact support@leadmagic.io","docs":"https://leadmagic.io/docs/api-reference/errors"}],"meta":{"request_id":"ea6e3248-f4d2-437d-bca3-20881b529129","timestamp":"2024-02-01T12:00:00.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1878ab7c-6585-47d3-aa53-7cc62cb86057":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).","scopes":[]}}},"servers":{"132f8068-ade7-4442-8c67-2b3abf0d6ed1":{"url":"https://api.leadmagic.io","description":"Production API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"v1/reference/openapi.yml"},"subdomain":"leadmagic","siteName":"LeadMagic","title":"Meta Ads — LeadMagic","contextualStarterQuestions":[{"_id":"6a0a5469bc99ca8297a255b6","deploymentId":"646ae281576147f78ecc947c","questionText":"How do I search Meta ads by domain?","status":"active","generatedBy":"contextual","path":"v1/reference/meta-ads-search","createdAt":"2026-05-17T23:51:05.569Z","updatedAt":"2026-05-17T23:51:05.569Z","__v":0},{"_id":"6a0a5469bc99ca8297a255b5","deploymentId":"646ae281576147f78ecc947c","questionText":"What's the rate limit for this API?","status":"active","generatedBy":"contextual","path":"v1/reference/meta-ads-search","createdAt":"2026-05-17T23:51:05.569Z","updatedAt":"2026-05-17T23:51:05.569Z","__v":0},{"_id":"6a0a5469bc99ca8297a255b4","deploymentId":"646ae281576147f78ecc947c","questionText":"How much does a Meta ads search cost?","status":"active","generatedBy":"contextual","path":"v1/reference/meta-ads-search","createdAt":"2026-05-17T23:51:05.569Z","updatedAt":"2026-05-17T23:51:05.569Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-17T23:50:51.655Z","originalFileLocation":"v1/reference/meta-ads-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search for Meta Ads by company domain or name.\">\u003cmeta data-mint-head name=\"application-name\" content=\"LeadMagic\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Meta Ads — LeadMagic\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST — Meta Ads endpoint documentation for LeadMagic API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"LeadMagic API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://leadmagic.io/docs/v1/reference/meta-ads-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leadmagic.io/opengraph-image\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Meta Ads — LeadMagic\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"B2B data enrichment API for email validation, lead enrichment, mobile discovery, and company intelligence.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leadmagic.io/opengraph-image\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/leadmagic/YCs0OVPbotrDi7rH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"LeadMagic\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"twitter:url\" content=\"https://leadmagic.io/docs\">\u003cmeta data-mint-head name=\"charset\" content=\"UTF-8\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"author\" content=\"LeadMagic\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#7C3AED\">\u003cmeta data-mint-head name=\"format-detection\" content=\"telephone=no\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@leadmagichq\">\u003clink data-mint-head rel=\"canonical\" href=\"https://leadmagic.io/docs/v1/reference/meta-ads-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/v1/reference/meta-ads-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://leadmagic.io/#organization\",\"name\":\"LeadMagic\",\"url\":\"https://leadmagic.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/leadmagic/_o4X9taQ-eKpmHvO/logo/light.svg?fit=max\u0026auto=format\u0026n=_o4X9taQ-eKpmHvO\u0026q=85\u0026s=586839aef34c6fa857b3a749aa11ec54\"}},{\"@type\":\"WebSite\",\"@id\":\"https://leadmagic.io/docs#website\",\"name\":\"LeadMagic\",\"url\":\"https://leadmagic.io/docs\",\"publisher\":{\"@id\":\"https://leadmagic.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search#webpage\",\"url\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search\",\"name\":\"Meta Ads Search\",\"description\":\"Search for Meta Ads by company domain or name.\",\"dateModified\":\"2026-05-17T23:50:51.655Z\",\"isPartOf\":{\"@id\":\"https://leadmagic.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://leadmagic.io/docs/v1/reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ads\",\"item\":\"https://leadmagic.io/docs/v1/reference/google-ads-search\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Meta Ads Search\",\"item\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search#apireference\",\"headline\":\"Meta Ads Search\",\"name\":\"Meta Ads Search\",\"description\":\"Search for Meta Ads by company domain or name.\",\"url\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search\",\"mainEntityOfPage\":{\"@id\":\"https://leadmagic.io/docs/v1/reference/meta-ads-search#webpage\"},\"image\":\"https://leadmagic.io/opengraph-image\",\"dateModified\":\"2026-05-17T23:50:51.655Z\",\"publisher\":{\"@id\":\"https://leadmagic.io/#organization\"},\"isPartOf\":{\"@id\":\"https://leadmagic.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"LeadMagic\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"LeadMagic","nav":{"global":null,"groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Introduction","icon":"play","href":"/v1/introduction"},{"title":"Quickstart","icon":"bolt","href":"/v1/quickstart"},{"title":"Use Cases","icon":"sparkles","href":"/v1/use-cases"},{"title":"Authentication","icon":"key","href":"/v1/authentication"},{"title":"Making API Calls","icon":"code","href":"/v1/making-api-calls"},{"title":"Credits \u0026 Pricing","icon":"coins","href":"/v1/credits"},{"title":"Developer Experience","icon":"code","href":"/v1/developer-experience"},{"title":"Integrations","icon":"plug","href":"/v1/integrations"},{"title":"Support \u0026 Policies","icon":"headset","href":"/v1/support"}]},{"group":"API Endpoints","icon":"code-merge","pages":[{"title":"API Reference","icon":"code","href":"/v1/reference/introduction"},{"group":"Account","icon":"gauge","expanded":false,"pages":[{"title":"Check Credits","openapi":"get /v1/credits","href":"/v1/reference/check-credits"},{"title":"Analytics API","openapi":"get /v1/analytics/dashboard","href":"/v1/reference/analytics"}]},{"group":"Email","icon":"envelope-open","expanded":false,"pages":[{"title":"Email Validation API","openapi":"post /v1/people/email-validation","href":"/v1/reference/email-validation"},{"title":"Email Finder API","openapi":"post /v1/people/email-finder","href":"/v1/reference/email-finder"},{"openapi":"post /v1/people/b2b-profile","title":"Email Address to B2B Person Profile","href":"/v1/reference/email-to-profile"},{"openapi":"post /v1/people/b2b-profile-email","title":"B2B Person Profile to Email","href":"/v1/reference/profile-to-email"},{"openapi":"post /v1/people/personal-email-finder","title":"Personal Email Finder","href":"/v1/reference/personal-email-finder"}]},{"group":"Contact","icon":"user","expanded":false,"pages":[{"openapi":"post /v1/people/profile-search","title":"B2B Person Profile","href":"/v1/reference/profile-search"},{"openapi":"post /v1/people/role-finder","title":"Role Finder","href":"/v1/reference/role-finder"},{"title":"Job Change Detector API","openapi":"post /v1/people/job-change-detector","href":"/v1/reference/job-change-detector"},{"openapi":"post /v1/people/mobile-finder","title":"Mobile Finder","href":"/v1/reference/mobile-finder"}]},{"group":"People","icon":"users","expanded":false,"pages":[{"title":"People Search","tag":"New","openapi":"post /v3/people/search","href":"/v1/reference/people-search"}]},{"group":"Company","icon":"building","expanded":false,"pages":[{"title":"Company Search","tag":"New","openapi":"post /v3/companies/search","href":"/v1/reference/company-search"},{"openapi":"post /v1/companies/company-funding","title":"Company Funding","href":"/v1/reference/company-funding"},{"title":"Company Lookalike","tag":"New","openapi":"post /v3/companies/lookalike","href":"/v1/reference/company-lookalike"},{"openapi":"post /v1/companies/technographics","title":"Company Technographics","href":"/v1/reference/technographics"}]},{"group":"Jobs","icon":"briefcase","expanded":false,"pages":[{"title":"Job Search","tag":"New","openapi":"post /v3/jobs/search","href":"/v1/reference/job-search"},{"title":"Search Stats","tag":"New","openapi":"post /v3/search/stats","href":"/v1/reference/search-stats"},{"group":"Helpers","icon":"wand-magic-sparkles","expanded":false,"pages":[{"title":"Job Search Helpers","openapi":"post /v3/jobs/search/resolve","href":"/v1/reference/job-search-helpers"},{"title":"Job Search Companies","openapi":"get /v3/jobs/search/companies","href":"/v1/reference/job-search-companies"},{"title":"Job Search Tags","openapi":"get /v3/jobs/search/tags","href":"/v1/reference/job-search-tags"},{"title":"Job Search Titles","openapi":"get /v3/jobs/search/titles","href":"/v1/reference/job-search-titles"},{"title":"Job Search Occupation Taxonomy","openapi":"get /v3/jobs/search/occupation-taxonomy","href":"/v1/reference/job-search-occupation-taxonomy"},{"title":"Job Search Locations","openapi":"get /v3/jobs/search/locations","href":"/v1/reference/job-search-locations"},{"title":"Job Search Catalogs","openapi":"get /v3/jobs/search/catalogs","href":"/v1/reference/job-search-catalogs"}]},{"group":"Filters","icon":"filter","expanded":false,"pages":[{"openapi":"get /v1/jobs/countries","title":"Job Country","href":"/v1/reference/job-country"},{"openapi":"get /v1/jobs/regions","title":"Job Region","href":"/v1/reference/job-regions"},{"openapi":"get /v1/jobs/job-types","title":"Job Type","href":"/v1/reference/job-types"},{"openapi":"get /v1/jobs/company-types","title":"Job Company Type","href":"/v1/reference/job-company-types"},{"openapi":"get /v1/jobs/industries","title":"Job Industry","href":"/v1/reference/job-industry"}]},{"title":"Job Search","tag":"Deprecated","openapi":"post /v1/jobs/jobs-finder","href":"/v1/reference/jobs-finder"}]},{"group":"Ads","icon":"rectangle-ad","expanded":false,"pages":[{"openapi":"post /v1/ads/google-ads-search","title":"Google Ads Search","description":"Search for Google Ads run by a company to understand their advertising strategy.","href":"/v1/reference/google-ads-search"},{"openapi":"post /v1/ads/meta-ads-search","title":"Meta Ads Search","href":"/v1/reference/meta-ads-search"},{"openapi":"post /v1/ads/b2b-ads-search","title":"B2B Search Ads","description":"Search for B2B ads by company domain or name.","href":"/v1/reference/b2b-ads-search"},{"openapi":"post /v1/ads/b2b-ads-details","title":"B2B Ad Details","href":"/v1/reference/b2b-ad-details"}]}]},{"group":"MCP Server","icon":"server","tag":"Beta","pages":[{"title":"LeadMagic MCP Server","icon":"server","href":"/mcp/introduction"},{"title":"Setup","icon":"gear","href":"/mcp/setup"},{"title":"Authentication","icon":"key","href":"/mcp/authentication"},{"title":"Tools, Resources \u0026 Prompts","icon":"wrench","href":"/mcp/tools"},{"title":"Troubleshooting","icon":"circle-question","href":"/mcp/troubleshooting"}]},{"group":"CLI","icon":"terminal","tag":"Beta","pages":[{"title":"LeadMagic CLI","icon":"terminal","href":"/cli/introduction"},{"title":"Installation","icon":"download","href":"/cli/installation"},{"title":"Authentication","icon":"key","href":"/cli/authentication"},{"title":"Quickstart","icon":"bolt","href":"/cli/quickstart"},{"title":"Command Reference","icon":"book","href":"/cli/commands"},{"title":"AI Chat","icon":"message","href":"/cli/chat"},{"title":"Configuration","icon":"sliders","href":"/cli/configuration"},{"title":"Troubleshooting","icon":"circle-question","href":"/cli/troubleshooting"}]},{"group":"Compare","icon":"scale-balanced","hidden":true,"pages":[{"title":"Compare","icon":"scale-balanced","href":"/v1/compare"},{"title":"Alternatives","icon":"scale-balanced","href":"/v1/alternatives"}]}]},"basePath":"","title":"Meta Ads — LeadMagic","buildId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","deploymentId":"dpl_ATnXPMW25DMPUr9VBw6kL6MfBt6T","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CNqlzjVB.js","utils-BqFiXZ79.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CnR4QBe6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BY2ZM1OO.js","snippetPresets-x-8ACO8V.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CTxrMSpo.js","ApiExamples-Ch-SJE05.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CqqG_0NE.js","shallow-BXrZ2b0C.js","getApiPlaygroundDisplay-n7J_wkjq.js","CodeSnippet-CQsp4vyQ.js","CodeSnippets-BfuHqvZx.js","getPastedJson-BjrGIK1i.js","icon-7iLZnVOC.js","MethodPill-TBS1m84e.js","DuplicateIcon-BNMrV4Vs.js","createIcon-C5kCqeU2.js","DynamicMarkdown-Bq09mRwR.js","SectionHeading-G4Bflf5Q.js","axios-vUo_bRtp.js","Markdown-BTUds0aX.js","clsx-6wHzaN2_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BPypQKlo.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-o6bee4ro.js"]}